Skip to content

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

添加一甸园KB_脱源版（10文件）：项目概况/组织主数据/蓝图决策/操作特例/集成约定/上线问题/未决问题

parent 282501b8
Hide whitespace changes
Inline Side-by-side
Showing with 1768 additions and 0 deletions
KB_一甸园/00_项目概况.md 0 → 100644
View file @ 346d2f11
# 00 一甸园项目概况
> **文档类型**：项目 KB — 导航/上下文
> **加载策略**：每次对话优先加载，获取一甸园项目基本上下文
> **版本**：v1.0 | 2026-08-17
---
## 一、客户基本信息
| 项 | 值 |
|----|----|
| 客户名称 | 一甸园饮料（上海）有限公司（含关联公司：上海一甸园饮料销售有限公司） |
| 行业 | 食品饮料（果蔬汁/番茄汁等利乐包饮料，B2C 电商 + B2B 渠道） |
| 系统 | SAP S/4HANA Cloud Public Edition（CE 2602 实施） |
| 实施伙伴 | 帛丝（实施顾问团队） |
| 项目命名 | 一甸园 SAP 项目（外部系统：OMS 中台 + 聚水潭 + 云仓 WMS） |
| 上线时间 | 2024 年（数据切换点：3.31 库存调整、4.8 接口切换；以实际项目日历为准） |
| 当前阶段 | KB 构建阶段（指导书 2608 步骤 6） |
> 来源：业务蓝图方案 V1.0（2023-11-20）、数据规则约定 V1.1（2023-11-17）、项目周报（2024-01-08）
---
## 二、实施范围
### 在范围内（模块 + 一句话范围）
| 模块 | 范围说明 |
|------|---------|
| **SD 销售** | B2C 电商（抖音/天猫/京东/拼多多/有赞/视频号/快团团/小红书）、B2B（经销商/直营/商超/餐饮）、跨公司销售（A200 卖、A101 发货）、私域、样品赠送、销售寄样、B2B/B2C 退货/退换/仅退款 |
| **MM 采购/仓储** | 原材料/生产辅材（工厂 A101）采购、履约包材/赠品周边（云仓）采购、委外（代工厂）、拆装包（云仓）、库存调拨（工厂↔云仓、云仓↔云仓）、成本中心领料、费用采购、采购退换货、盘点 |
| **PP 计划** | 独立需求计划（MD61/62/63）、MRP 运行、物料覆盖范围监控、委外生产计划 |
| **QM 质量** | 原材料/成品/履约包材质检、检验计划、检验批、使用决策（成品质检仅上传质检报告） |
| **FI/CO 财务** | 应付账款（预制发票/付款申请/清账）、应收账款（形式发票/收款清账）、固定资产（采购/报废/变卖/折旧/转移）、员工借款/报销、月结、年结、成本中心 |
### 明确不在范围
- 生产执行（离散/重复制造工单）——一甸园生产采用 **委外加工**，不做厂内工单生产（工厂 A101 仅为收货/发料/质检点）
- 定制开发内部逻辑（接口 RICEFW 内部实现）——见 `集成约定.md`，只记录触点
- 银企直联等第三方资金系统——付款通过 SAP 付款申请 + 出纳手工付款
- 电商履约（聚水潭/云仓 WMS 内部操作）——SAP 只管结果过账
> 来源：业务蓝图方案 V1.0 §1-§9；委托业务见 BP-05-002、拆装包见 BP-05-003
---
## 三、业务场景编号索引（蓝图）
| 编号 | 场景 | 说明 |
|------|------|------|
| SAP-YDY-BP-01 | 一甸园业务主场景 | 销售/采购/仓库/财务全模块正向流程总览 |
| SAP-YDY-BP-02 | 电商业务场景 | -001 整单退货、-002 退换货、-003 仅退款、-004 私域平台、-005 采购退换货（云仓）、-006 采购退换货（工厂） |
| SAP-YDY-BP-03 | B2B 销售 | 主场景、-001 退货、-002 退换货、-003 样品赠送 |
| SAP-YDY-BP-04 | 跨公司销售 | 上海一甸园销售公司（A200）向客户售货，一甸园饮料（A100）工厂发货 |
| SAP-YDY-BP-05 | 独立需求计划 | -001 计划、-002 委外、-003 拆装包（云仓）、-004 B2C 旧批次换料 |
| SAP-YDY-BP-06 | 采购业务 | -001 库存调拨（工厂→云仓）、-002 库存调拨（云仓→云仓）、-003 费用采购、-004~-007 成本中心领料（云仓物料/工厂原料/工厂产成品/云仓产成品）、-008 盘点、-009 原材料/生产辅材（工厂）采购、-010 履约包材/赠品周边（云仓）采购 |
| SAP-YDY-BP-07 | 质量检验 | -001 质检主数据维护、-002 质量检验 |
| SAP-YDY-BP-08 | 固定资产 | -001/-002 采购、-003 报废、-004 变卖、-005 折旧、-006 转移 |
| SAP-YDY-BP-09 | 财务 | -001 应付账款确认、-002 应付付款及清账、-003 应收账款确认、-004 应收收款及清账、-005 员工借款、-006 员工报销、-007 月结、-008 年结 |
> 来源：业务蓝图方案 V1.0 目录（2023-11-20）
---
## 四、关键干系人（真实名单）
> ⚠️ 姓名为项目文档真实值；岗位/部门以蓝图与业务分工表为准。名单用于确认操作 Owner，非账号信息。
### 客户方
| 姓名 | 角色/业务线 | 来源 |
|------|-----------|------|
| 张仁玲 | 计划专员：独立需求计划、MRP、委外订单、UB 转储单创建、拆装包订单、采购收货 | 蓝图 BP-01/05/06、业务分工表 |
| 胡明星 | 采购主管/物流：采购订单审批、预付款、运费、物流找车、发票预制 | 蓝图 BP-01/03/06 |
| 汪莎莎 | 采购执行：创建采购订单、采购收货过账、预制供应商发票、供应商主数据 | 业务分工表 2024-03-20 |
| 倪总 | 计划总监/审批：采购订单/委外订单/拆装包订单审批 | 蓝图 BP-05/06 |
| 代进强 | 质量主管：物料/BOM/生产版本/质检主数据、记录检验结果、使用决策、寄样出库 | 蓝图 BP-07、业务分工表 |
| 洪飞 | 制单员：OMS 改单、销售订单/交货单创建、换货单 | 蓝图 BP-01/02/03 |
| 鲁倩倩 | 销售助理：创建客户、导入价格清单 | 蓝图 BP-03 |
| 鲁玖贤 | 财务：审批订单、形式发票、盘点发起/过账、仓储物流服务费月结 | 蓝图 BP-03/06、业务分工表 |
| 毛晓春 | 应付会计：发票过账 | 蓝图 BP-01 |
| 陶灵峰 | 销售经理：订单/退货/样品审批 | 蓝图 BP-03 |
| 吴晓军 | IT：用户主数据、预留单创建（成本中心领料） | 业务分工表 |
| 刘亚波 | 云仓负责人：收发货、UB 单收发货、拆装包、TOC 退货、物流箱出库 | 业务分工表 |
| 帛丝-接口开发负责人 | 接口开发负责人（移动类型/接口设计记录作者） | 接口设计记录 V1.0 |
### 项目外部系统 Owner
| 系统 | 用途 | 对应接口 |
|------|------|---------|
| OMS（中台） | 订单/单据流转中枢 | 详见 `集成约定.md` |
| 聚水潭 | 电商订单履约 + WMS 对接 | 采购入库/其他出入库/销售出库等接口 |
| 云仓 WMS | 天津(景天)/无锡(景天)/昆山(旺店通) 实物仓 | 仓库操作结果回传 |
---
## 五、系统架构（三层）
```
电商平台（抖音/天猫/京东/拼多多/有赞/视频号/快团团/小红书）
↓ OMS 抓单
OMS 中台 ──↔── 聚水潭（履约/发货）──↔── 云仓 WMS（天津/无锡/昆山/上海）
│ ↑ 接口（产品/订单/单据回传，见 集成约定.md）
↓
SAP S/4HANA Cloud（一甸园双公司：A100 生产 + A200 销售）
├── A101 一甸园工厂（原料仓/包材仓/成品仓）
├── A201 销售工厂（成品仓，跨公司场景）
└── 云仓库存地点（A104天津/A105无锡/A106昆山/A107上海）挂在 A101 下
```
> 来源：中台方案设计、接口确认记录 V1.1、数据规则约定 §1.8
---
## 六、关联 KB 文件
| 层 | 位置 | 用途 |
|----|------|------|
| **一甸园项目 KB（本层）** | `KB_一甸园/` | 客户专属事实（本文件集） |
| SC Base KB | `KB_SC/` | 标准操作步骤（引用，不重写） |
| SA KB | `KB_SA/` | 功能存在性 / Scope Item（引用） |
**一甸园 KB 文件清单**：00_项目概况、组织与主数据_真实值、蓝图决策记录、操作特例_SD_销售、操作特例_MM_采购仓储、操作特例_PP_QM_生产质量、操作特例_FI_CO_财务、集成约定、上线问题记录、未决问题清单。
**冲突裁决**：一甸园 KB（客户决策）> 蓝图 > SC Base > SA。
---
*00_项目概况.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 业务蓝图方案 V1.0 | 蓝图业务场景规划文档 V1.0 |
| 数据规则约定 V1.1 | 数据规则说明文档 V1.1 |
| 数据规则约定 | 数据规则说明文档 |
| 项目周报（2024-01-08） | 周报 20240108 |
| 中台方案设计 | OMS 方案设计 |
| 接口确认记录 V1.1 | 接口确认文档 V1.1 |
| 业务分工表 | 业务线分工表 |
| 帛丝（实施顾问团队） | 帛丝（顾问：莫宇鹏、李宝旭、单鹏辉 等） |
| 帛丝-接口开发负责人 | 李宝旭（帛丝） |
| 接口设计记录 V1.0 | 接口文档 V1.0 |
| 接口开发负责人 | 李宝旭 |
KB_一甸园/上线问题记录.md 0 → 100644
View file @ 346d2f11
# 上线问题记录
> **文档类型**：项目 KB — 上线过程操作记录与事后复盘
> **用途**：记录上线期（3.31 库存调整、4.8 接口切换）已发生的操作与问题，供后续月结/复盘参考。**事实以凭证号/文档为准，不推断。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：`3.31 库存调整记录` 目录 9 份文件、接口确认记录 V1.1
---
## 一、3.31 库存调整（期初库存导入）
**背景**：上线切换日 3.31，将原系统（OMS/线外）库存按批次、按库存地点导入 SAP，同时做差异调整（O 库存→非限制、增减前调整、云仓各仓调整、补仓）。
**操作步骤与物料凭证（真实凭证号）**：
| 步骤 | 描述 | 物料凭证 |
|------|------|---------|
| 1 | 调整 O 库存至非限制库存 A103 | 4900000417 |
| 2 | 3.31 增减前-调整批次 | 4900000418 |
| 3 | 移动类型 201，成本中心 A1000304 采购部，科目 9001900000 期初库存导入 | 4900000438 |
| 4 | 移动类型 202，成本中心 A1000304 采购部，科目 9001900000 期初库存导入 | 4900000419 |
| 5 | 天香库存调整 | 4900000440 |
| 6 | 昆山库存调整 | 4900000441 |
| 7 | 无锡库存调整 | 4900000442 |
| 8 | 天津库存调整 | 4900000443 |
| 9 | 昆山仓补仓 | 4900000439 |
**关键信息**：
- 期初库存导入科目：**9001900000**（冲销科目 9XXX 初始化）。
- 成本中心：**A1000304 采购部**。
- 调整地点：A103 自有仓 + 天香代工厂 + 云仓（昆山/无锡/天津）。
- 调整操作人：接口开发负责人（顾问指导），实际在系统执行待业务确认。
> 来源：`3.31 库存调整记录` 目录 Excel。
---
## 二、4.8 接口切换（2024.04.08）
**背景**：第一批接口切换上线，SAP 与 OMS/聚水潭数据流正式打通。**数据拉取起点为 4月9日早上 10 点当天及之后的所有数据**。
**已切换接口（确认 V1.1，2024.04.08）**：
| 功能 | 接口 | 聚水潭接口 | 频率 | 状态 |
|------|------|-----------|------|------|
| 采购入库 | 中台→OMS / OMS→中台 | 采购入库单 | 3 分钟 | 已切换 |
| 采购退货 | 中台→OMS / OMS→中台 | 采购退货单 | 5 分钟 | 已切换 |
| B2B 销售出库 | 中台→OMS（外向交货/寄样） | 接聚水潭销售订单创建接口 | 1 分钟 | 已切换 |
| B2B 销售退货 | 中台→OMS / OMS→中台 | 接聚水潭其他入库创建接口 | 2 分钟 | 已切换 |
| 拆装功能 | 4 条（委外出入库） | 其它入库/出库单 | 1 分钟 | 已切换 |
| 移库出入库 | 4 条（UB 单） | 工厂→云仓：采购入库单；云仓→云仓：其它出入库 | 3 分钟 | 已切换 |
| 结算单（C端） | — | 接聚水潭销售出库单查询接口 | 每天 4点/16点 | 已切换 |
| 销售寄样单 | — | 接聚水潭销售出库单查询接口 | 每天 12点/24点 | 已切换 |
**待切换（2024.4.19）**：
| 功能 | 接口 | 状态/原因 |
|------|------|----------|
| 成本中心入库 | 9-1/9-2 | 有功能变动完成后切换 |
| 成本中心出库 | 10-1~10-3 | 待切换 |
| 物流箱出库 | 11-1 | 测试完毕后切换 |
| 物料主数据 | 产品主数据接口 | 已切换（1 小时频率） |
> 来源：接口确认记录 V1.1（与接口切换安排 v1.2 一致）。
---
## 三、接口联调测试记录（上线前）
见 `集成约定.md` §五，抽取 5 场景测试（UB 工厂→云仓 / UB 云仓→云仓 / 拆装包 / 采购入库 / 采购退货），测试值含批次与生产/过期日期。无遗留问题记录。
---
## 四、已知历史事件时间线
| 日期 | 事件 | 来源 |
|------|------|------|
| 2023-11-20 | 物料凭证接口设计记录 V1.0（接口开发负责人） | 接口设计记录 |
| 2023-11-12 | 业务测试脚本 V1.0 发布 | `业务测试脚本（2023-11）.xlsx` |
| 2023-11-14 | 中台集成开发计划 V1.4 | 接口设计记录 |
| 2024-03-20 | 业务分工会议确认 | `业务分工会议记录（2024-03-20）` |
| 2024-03-30 | 接口打通前置目标（完成历史采购/生产单据补录） | 业务分工表 |
| 2024-03-31 | 期初库存调整（9 步，凭证 4900000417-4900000443） | `3.31 库存调整记录` |
| 2024-04-01 | 产品主数据同步接口设计记录 v1.0（接口开发负责人） | 接口设计记录 |
| 2024-04-08 | 接口第一批切换（采购/B2B/拆装/移库/结算/寄样） | 接口确认记录 V1.1 |
| 2024-04-19 | 接口第二批切换计划（成本中心/物流箱/物料主数据） | 接口确认记录 V1.1 |
---
*上线问题记录.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 3.31 库存调整记录 | 一甸园3.31日库存调整-BOS李宝旭／一甸园3.31日库存调整/ |
| 接口确认记录 V1.1 | 接口确认文档 V1.1／接口确认 V1.1 |
| 接口切换安排 v1.2 | 切线安排 v1.2 |
| 物料凭证接口设计记录 V1.0 | 移动类型-物料凭证创建接口设计 V1.0 |
| 中台集成开发计划 V1.4 | OMS 集成开发计划 V1.4 |
| 业务测试脚本（2023-11） | SAP_M3_业务测试脚本_20231112_V1.0 |
| 业务测试脚本 | SAP_M3 业务测试脚本 |
| 业务分工会议记录（2024-03-20） | 一甸园SAP业务线具体负责人更新-会议概览-20240320.xlsx |
| 业务分工会议确认 | 业务线具体负责人会议确认 |
| 业务分工表 | 业务线分工表 |
| 产品主数据同步接口设计记录 v1.0 | 产品主数据接口 v1.0 |
| 接口设计记录 | 接口相关文件/ |
| 接口开发负责人 | 李宝旭 |
KB_一甸园/操作特例_FI_CO_财务.md 0 → 100644
View file @ 346d2f11
# 操作特例_FI_CO_财务
> **文档类型**：项目 KB — FI/CO 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：蓝图 BP-08/09、数据规则约定 §1-2、业务分工表（2024-03-20）
---
## 一、实施 Scope Item 清单
| Scope Item ID | 名称 | 一甸园用法 | Base KB 引用 |
|--------------|------|-----------|-------------|
| J58 | Accounting and Financial Close | 总账/月结/年结 | `KB_SC/KB_FI_J58_Accounting-and-Financial-Close.md` |
| J60 | Accounts Payable | 应付账款确认/付款清账 | `KB_SC/KB_FI_J60_Accounts-Payable.md` |
| J59 | Accounts Receivable | 应收账款确认/收款清账 | `KB_SC/KB_FI_J59_Accounts-Receivable.md` |
| J62 | Asset Accounting | 固定资产（采购/折旧/报废/变卖/转移） | `KB_SC/KB_FI_J62_Asset-Accounting.md` |
---
## 二、组织与科目真实值
- **公司代码**：A100 一甸园饮料（上海）有限公司、A200 上海一甸园饮料销售有限公司；控制范围 A000；会计科目表 YCOA。
- **会计科目**：10 位，财政部统一编码；一级 4 位（1XXX 资产/2XXX 负债/4XXX 权益/5XXX、8XXX 成本费用/6XXX 损益/9XXX 初始化）。**期初库存导入科目 9001900000**。
- **统驭科目**：应收账款/应收票据/其他应收款/预收账款、应付账款/应付票据/其他应付款/预付账款均做未清项管理；**应付账款-暂估**科目用于 GR/IR 未清项管理。
- **利润中心/成本中心**：见 `组织与主数据_真实值.md` §二（渠道损益 + 部门费用归集）。
> 来源：数据规则约定 §1-2。
---
## 三、应付账款（J60）— 高频路径
### 3.1 应付账款确认（BP-09-001）
1. 采购部预制供应商发票（汪莎莎，App"预制供应商发票"：公司代码/发票日期/采购订单号/金额）→ 2. 财务核对预制发票/合同（毛晓春）→ 3. 财务过账预制发票形成应付（App"供应商发票清单"，借：应付暂估/在途物资 借：进项税 贷：应付账款）→ 4. GR/IR 自动清账（重过账收货/收发票清账）。
### 3.2 应付账款付款及清账（BP-09-002）
1. 采购部提交需要付款项目（创建付款申请，选发票项目）→ 2. 采购总监提交付款申请 → 3. 资金主管审批（管理付款申请-现金经理）→ 4. 出纳确认付款银行及金额（系统自动清账，借：应付账款 贷：银行存款）→ 5. 查看付款明细 → 6. 付款清账（过账付款）。
标准步骤参见 `KB_SC/KB_FI_J60_Accounts-Payable.md §供应商发票过账/付款清账`。
⚠️ 一甸园特例：
- 预制发票人：**汪莎莎**（业务线分工确认，蓝图 BP-01 标注张仁玲/胡明星）→ 以业务分工表 2024-03-20 为准。
- 发票过账：**毛晓春**（应付会计）。
- 预付款流程：原材料/云仓采购常需**预付供应商**（先付后提货），采购员建预付款申请（汪莎莎）→ 付款申请 → 财务付款（蓝图 BP-06-009/010 步骤 5-7）。
---
## 四、应收账款（J59）— 高频路径
### 4.1 应收账款确认（BP-09-003）
1. 基于交货单创建形式销售发票（洪飞，App"显示开票凭证"，借：应收账款 贷：主营业务收入 贷：销项税）→ 2. 财务过账（鲁玖贤）。
### 4.2 应收账款收款及清账（BP-09-004）
1. 出纳导入银行回单（App"处理银行回单"）→ 2. 应收会计辨识收款过账（App"收款过账"，输入外部交易类型）→ 3. 收款清账（选择未清项，借：银行存款 贷：应收账款）→ 4. 查看日记账分录。
标准步骤参见 `KB_SC/KB_FI_J59_Accounts-Receivable.md §开票/收款清账`。
⚠️ 一甸园特例：跨公司销售（A200）自动生成 A200 对客户应收 + A100 对 A200 应收 + A200 对 A100 应付（见 `操作特例_SD_销售.md` §六）。
---
## 五、固定资产（J62）
### 5.1 资产采购（两方案）
**方案一**（BP-08-001）：1. 需求部门线下申请→部门领导审批 → 2. 财务创建资产卡片（App"管理固定资产"）→ 3. 采购部申请资产采购（采购申请 ZY3）→ 4. 创建采购订单（**科目分配类别选"资产"**）→ 5. 审批 → 6. 资产验收（过账货物移动）→ 7. 预制发票 → 8. 发票过账（借：固定资产 借：进项税 贷：应付账款/银行存款）。
**方案二**（BP-08-002）：1. 创建资产主数据 → 2. 资产验收 → 3. 资产资本化（过账购置，集成/非集成应付）。
### 5.2 资产其他场景
| 场景 | 操作 | 说明 |
|------|------|------|
| 报废 | 过账报废-集成应收账款-无客户 | 无客户报废 |
| 变卖 | 过账报废-集成应收账款-有客户 | 有客户报废 |
| 折旧 | 计划资产会计作业（测试运行→正式运行） | 直接折旧法 CD01，次月折旧，5 年，残值率 5% |
| 转移 | 过账转移-公司代码内 | 资产→资产（可转移至新资产或已资本化资产） |
标准步骤参见 `KB_SC/KB_FI_J62_Asset-Accounting.md §资产购置/折旧/报废`。
⚠️ 一甸园特例：资产类别 **3300 电子设备**（编码 33000000000-33009999999），折旧码 CD01。
---
## 六、员工借款/报销
- **员工借款**（BP-09-005）：钉钉申请审批 → 财务付款 → 总账过账一般日记账分录（借：银行存款 贷：其他应付款-个人）。
- **员工报销**（BP-09-006）：钉钉申请审批 → 总账过账（借：费用科目 贷：银行存款/其他应付款-个人）。
> ⚠️ 员工（一甸园）作为供应商分组 **Z004**（0080000000-0089999999），用于借款/报销的个人往来。来源：数据规则约定 §2.7。
---
## 七、月结/年结（J58）
### 7.1 月结（BP-09-007）
1. 检查手工单据完结（管理日记账分录）→ 2. 检查收付款完结（管理付款申请/处理银行回单）→ 3. 打开下一记账期间（管理过账期间/MMPV）→ 4. 运行资产折旧（计划资产会计作业）→ 5. **GR/IR 重分类**（重过账收货/收发票清账，关键日期月末最后一天，冲销过账日期下月 1 号，正式运行定义会话名称）→ 6. 费用分摊分配（运行分配）→ 7. 关闭上一记账期间。
### 7.2 年结（BP-09-008）
1. 打开特殊记账期间 → 2. 录入调账凭证 → 3. 余额结转（计划总账作业）→ 4. 开启下一资产年度 → 5. 出具年度报表（资产负债表/利润表）→ 6. 关闭上一年度期间。
标准步骤参见 `KB_SC/KB_FI_J58_Accounting-and-Financial-Close.md §月结/年结`。
---
## 八、成本中心/利润中心（CO）
- 成本中心领料过账（201/202）成本中心**必填真实值**（如 A1000304 采购部），见 `操作特例_MM_采购仓储.md` §六。
- 利润中心与电商渠道/大区一一对应（A100101 天猫、A100102 抖音…），用于渠道损益分析。
- 仓储物流服务费：月结、财务单独记账处理（鲁玖贤）。来源：业务分工表 2024-03-20。
---
## 九、关键操作提示
- 应付：预制发票人（汪莎莎）与过账人（毛晓春）权限分离。
- 应收：形式发票创建（洪飞）与过账（鲁玖贤）权限分离。
- 月结 GR/IR 重分类是重点，冲销日期固定下月 1 号。
- 固定资产采购订单科目分配类别选"资产"、先建卡片再采购。
---
*操作特例_FI_CO_财务.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 数据规则约定 | 数据规则说明文档 |
| 业务分工表 | 业务线分工表 |
KB_一甸园/操作特例_MM_采购仓储.md 0 → 100644
View file @ 346d2f11
# 操作特例_MM_采购仓储
> **文档类型**：项目 KB — MM 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：物料管理操作手册（2023-11）、物料凭证接口设计记录（接口开发负责人 2023-11-20）、蓝图 BP-05/06、接口测试记录、盘点操作手册
---
## 一、实施 Scope Item 清单
| Scope Item ID | 名称 | 一甸园用法 | Base KB 引用 |
|--------------|------|-----------|-------------|
| J45 | Procurement of Direct Materials | 原材料/生产辅材（工厂 A101）采购 | `KB_SC/KB_MM_J45_Procurement-of-Direct-Materials.md` |
| BNX | Consumable Purchasing | 费用类采购（ZY4） | `KB_SC/KB_MM_BNX_Consumable-Purchasing.md` |
| BMY | Subcontracting | 委外业务（ZY2） | `KB_SC/KB_MM_BMY_Subcontracting.md` |
| BMK | Return to Supplier | 采购退换货（ZY6） | `KB_SC/KB_MM_BMK_Return-to-Supplier.md` |
| BME | Stock Transfer with Delivery | 库存调拨（UB） | `KB_SC/KB_MM_BME_Stock-Transfer-with-Delivery.md` |
| BMH | Stock Transfer without Delivery | 工厂内转储/批次调整（311） | `KB_SC/KB_MM_BMH_Stock-Transfer-without-Delivery.md` |
| BMC | Core Inventory Management | 库存管理基础 | `KB_SC/KB_MM_BMC_Core-Inventory-Management.md` |
| BML | Physical Inventory | 盘点 | `KB_SC/KB_MM_BML_Physical-Inventory.md` |
| J44 | Material Requirements Planning | MRP（配合 PP） | `KB_SC/KB_MM_J44_Material-Requirements-Planning.md` |
---
## 二、采购业务特例
### 2.1 采购申请类型选择（一甸园专有）
| 场景 | 采购申请类型 | 采购订单类型 | 要点 |
|------|------------|------------|------|
| 库存类采购 | ZY1（6000 段） | ZY1（9000 段） | 正常采购 |
| 委外生产 | ZY2（6100 段） | ZY2（9100 段） | 项目类别 L；加工费由采购信息记录代入 |
| 资产采购 | ZY3（6200 段） | ZY3（9200 段） | 科目分配类别选"资产"，先建资产卡片 |
| 费用采购 | ZY4（6300 段） | ZY4（9300 段） | **必勾"无价值收货/收货未评估"** |
| 拆装包 | ZY5（6400 段） | ZY5（9400 段） | 项目类别 L，组件集中输入 |
| 退货 | ZY6（6500 段） | ZY6（9500 段） | **必勾"退货"** |
| 库存调拨 | — | UB（4500 段） | 供货/收货工厂 + 运费 |
> 来源：物料管理操作手册 §5、数据规则约定 §3.1-3.2。
> ⚠️ 审批：蓝图标注采购申请/订单审批"现在无审批，需确认审批流"——**未决**，见 `未决问题清单.md`。
### 2.2 原材料/生产辅材（工厂）采购 — 高频路径
1. MRP 运行生成采购申请（张仁玲）→ 2. 处理采购申请（胡明星，选供应商、调整）→ 3. 转/创建 ZY1 采购订单 → 4. 采购订单审批（倪总，待确认）→ 5. 预付款申请（如需要，胡明星）→ 6. 原材料收货（胡明星，**注意维护批次与双单位比例**）→ 7. 质检（代进强）→ 8. 预制供应商发票（胡明星）。
标准步骤参见 `KB_SC/KB_MM_J45_Procurement-of-Direct-Materials.md §采购订单创建/收货`。
⚠️ 一甸园特例：收货后**强制走质检**（移动类型触发检验批），见 `操作特例_PP_QM_生产质量.md` QM-01。
### 2.3 履约包材/赠品周边（云仓）采购 — 高频路径
1. 创建 ZY1 采购订单（胡明星批量）→ 2. 审批（倪总）→ 3. OMS 根据 SAP 采购订单自动创建采购入库单 → 4. 云仓收货 → 5. 中台调 SAP 收货过账（**自动同步，注意维护批次与双单位比例**）→ 6. 预制供应商发票（胡明星）。
> 来源：蓝图 BP-06-010、物料管理操作手册。区别：工厂采购在 SAP 收货，云仓采购由 OMS/接口自动收货。
### 2.4 费用采购
标准步骤参见 `KB_SC/KB_MM_BNX_Consumable-Purchasing.md`。
⚠️ 一甸园特例：采购申请科目分配选 **K**、填短文本/物料组/成本中心；采购订单**必须勾"无价值收货"**（费用性采购不产生库存）。
### 2.5 采购退换货
- **云仓**：SAP 建退货订单（勾"退货"）→ 接口同步 OMS 建其他出库单 → 云仓退换货 → 中台调 SAP 出库过账 → 预制发票（仅退货时事务选"贷记凭证"）。见 `KB_SC/KB_MM_BMK_Return-to-Supplier.md`。
- **工厂**：SAP 手动退货出库 → 预制发票。蓝图 BP-02-006。
- ⚠️ 移动类型：已收货未结算用 122（参考收货物料凭证，需传 ReferenceDocumentFiscalYear / InvtryMgmtReferenceDocument / InvtryMgmtRefDocumentItem）；已收货且已结算用 **161**（GoodsMovementReasonCode 必填）。
> 来源：物料凭证接口设计记录 §5.1.7、物料管理操作手册 §6。
---
## 三、委外业务（BMY）
**一甸园生产全部走委外**（无厂内工单），成品由代工厂生产。标准步骤参见 `KB_SC/KB_MM_BMY_Subcontracting.md`。
### 高频路径（真实流程）
1. MRP 生成委外采购申请 ZY2（张仁玲）→ 2. 转 ZY2 委外生产订单（张仁玲，加工费来自采购信息记录/胡明星提供）→ 3. 审批（倪总）→ 4. 外协配料 541 发货至供应商库存（代进强）→ 5. 委外收货 101 + 子件消耗 543（张仁玲）→ 6. 质检（代进强）→ 7. 预制供应商发票（加工费，胡明星）。
### 移动类型（接口调用）
| 步骤 | 移动类型 | 特殊要求 |
|------|---------|---------|
| 委外发料 | 541 | 需传 Supplier、采购订单 |
| 委外收货（成品） | **Z10**（一甸园自定义） | InventoryStockType 01、需传 Supplier；或 101 |
| 子件消耗 | 543 | 特殊库存类型 O；含批次子件**必须传子件消耗量**（见 3.1） |
| 消耗/收货冲销 | 544/102 | 参考 102 操作 |
> 来源：物料凭证接口设计记录 §5.1.6、§5.1.8；蓝图 BP-05-002。
> ⚠️ **Z10 用于委外入库同步耗料**：SAP 委外订单收货时若不传子件，系统按标准比例扣减；**子件含批次必须传消耗量**（MaterialDocumentParentLine 指向母件行）。
---
## 四、拆装包业务（云仓）
**一甸园专有**：云仓拆大包装→组合装，走拆装包委外订单 ZY5。
### 高频路径
1. 创建 ZY5 拆装包采购订单（张仁玲，项目类别 L，组件集中输入，含云仓人工费）→ 2. 审批（倪总）→ 3. 拆包发料 541 给供应商（张仁玲/接口）→ 4. 云仓拆包→ 5. **装包自动收货**（接口，移动类型 Z10 + 543 消耗）→ 6. 预制供应商发票（云仓人工费，胡明星）→ 7. 付款申请（胡明星）。
> ⚠️ **关键特例**：因启用 QM，拆装包收货**必须用顾问自定义移动类型**（Z10），否则进入质检流程。来源：蓝图 BP-05-003/004 步骤 4。
> 接口链路：SAP→OMS 拆包指令（SAP 发出）→ OMS→SAP 装包指令（OMS 发出）。来源：业务测试脚本 步骤 18/19。
---
## 五、库存调拨（BME）— UB 转储单
### 5.1 工厂→云仓（A101→A104/A105/A106/A107）
1. 创建 UB 转储订单（张仁玲，**注意填写入库仓库**）→ 2. 物流员填运费/预付款（胡明星）→ 3. 调拨发货 351（仓库到在途，胡明星，物流信息记录在文本）→ 4. 中台创建 OMS 出/入库单 → 5. 云仓收货确认 → 6. 中台调 SAP 收货过账 101。
标准步骤参见 `KB_SC/KB_MM_BME_Stock-Transfer-with-Delivery.md`。
移动类型：351 调拨发货（GoodsMovementCode 04，IssuingOrReceivingStockType 06）/ 101 调拨收货。
### 5.2 云仓→云仓（A104→A105 等）
同链路：张仁玲创建 UB → 胡明星找车/记录物流 → 中台创建 OMS 单据 → 云仓发货/收货 → 中台调 SAP 过账（出库 351/收货 101）。
> 来源：蓝图 BP-06-001/002、物料凭证接口设计记录 §5.1.9、接口测试记录（UB 单 4500000005/4500000485/4500000460）。
### 5.3 工厂内转储/批次调整（311）
用于工厂内存储地点转移、批次调整。`KB_SC/KB_MM_BMH_Stock-Transfer-without-Delivery.md`。启用批次物料**批次号必填**。
---
## 六、成本中心领料（201/202/Z01-Z04）
### 6.1 四场景（见 `蓝图决策记录.md` MM-06）
| 场景 | 链路 | 移动类型 |
|------|------|---------|
| 云仓物料 | 预留单→OMS 其他出→OMS 出库→接口自动 SAP 过账 | 201 |
| 工厂原料 | 预留单→SAP 手动发货 | 201 |
| 工厂产成品 | 预留单→SAP 手动发货 | 201 |
| 云仓产成品 | 预留单→OMS 其他出→接口自动 | 201 |
### 6.2 标准操作
1. 创建预留单（仓库主管/吴晓军，App"管理手动预留"）→ 2. 基于预留单发货（App"过账货物移动"，201，填物料/数量/工厂/存储地点/**成本中心**）。
标准步骤参见 `KB_SC/KB_MM_BMC_Core-Inventory-Management.md §货物移动`。
⚠️ 一甸园特例：成本中心**必须填真实值**（如 A1000304 采购部、A1000302 仓库物流部），见 `组织与主数据_真实值.md` §2.2。接口调用时 Reservation/ReservationItem/CostCenter 必填。
### 6.3 样品相关（移动类型 Z01-Z04）
| 移动类型 | 用途 | 说明 |
|---------|------|------|
| Z01 | 成本中心样品发出 | 寄样出库（代进强），需预留单 |
| Z02 | 成本中心样品退回 | 样品退回入库 |
| Z03 | 成本中心报废处理 | — |
| Z04 | 成本中心报废冲销 | — |
> 来源：物料凭证接口设计记录 §5.1.12-5.1.13。
---
## 七、库存管理高频移动类型总表（一甸园）
> 标准 App：`过账货物移动`（MIGO 等价物，见 `KB_SC/KB_REFERENCE_OPOnly_Tools.md`）。
| 移动类型 | 用途 | 一甸园要点 |
|---------|------|-----------|
| 101 | 采购/生产入库 | 收货-采购订单；双单位物料注意比例 |
| 102 | 收货冲销 | 取消-物料凭证 |
| 122/161 | 供应商退货 | 122 需参考收货凭证；161 用于已结算 |
| 123/162 | 退货冲销 | 参照 102 |
| 201/202 | 成本中心出/入库 | 需填成本中心 |
| 311/312 | 工厂内转储/批次调整 | 批次物料批次必填 |
| 343/344 | 冻结↔非限制 | 收货-其他 |
| 351 | UB 调拨发货（仓库到在途） | 转储专用 |
| 423E/424E | 退换货冻结→非限制（带销售订单） | 换货退货物料默认冻结 |
| 501/502 | 无源收/冲销 | — |
| 511/512 | 免费收货/冲销 | 需供应商 |
| 541/542 | 委外发料/冲销 | 需传供应商 |
| 543/544 | 委外消耗/冲销 | 子件特殊库存 O |
| 551/552 | 报废/冲销 | 无价值工厂；需成本中心 |
| 601/602/653/654/657/658 | 销售出库及冲销 | **走交货单过账，不直接创建物料凭证** |
| 631/632/633/634 | 退回及冲销 | 走交货单 |
| 901/902 | 样品销售/冲销 | 参照 201 |
| 903/904 | 非工单成本中心领料/冲销 | 参照 201 |
| 921/922/923/924 | 生产发料/退料（BOM 外） | 进成本中心，填总账科目+成本中心 |
| 925/926 | 研发领料（带预算号）/冲销 | 参照 921 |
| 935/936、939/940 | 有价值↔无价值工厂转移 | 参照 935 |
| 943/944 | 研发/工程入库（无价值工厂） | 参照 501 |
| 955/956 | 客退转无价值工厂 | 参照 935 |
| Z10 | 委外/拆装包入库（同步耗料） | **一甸园自定义**，绕过 QM |
| Z01-Z04 | 样品/报废（成本中心） | 需预留单 |
> 来源：物料管理操作手册 §6、物料凭证接口设计记录 §5。
---
## 八、盘点特例
### 8.1 高频路径（ES 盘点手册）
1. **创建库存盘点凭证**（财务鲁玖贤发起）：App"创建库存盘点凭证"→ 选工厂（A101/A201）→ 选库存地点（A101-A107/A201）→ 勾选物料行 → 凭证结构（可按仓位/物料组/物料拆分，最大项目数默认 20）→ **设置过账冻结**（建议勾选）。
2. **打印盘点凭证**：App"创建库存盘点凭证"→ 输出请求选"创建请求"。
3. **录入盘点结果**：App"管理库存盘点"→ 输入盘点凭证号 → 录入实际盘点数量。
4. **显示盘点差异**：App"处理库存盘点结果"→ 显示账面/盘点/差额数量与金额。
5. **盘点差异过账**：选中行项目 → 过账 → 生成物料凭证号。差异过大可重盘或标记删除。
6. **批量创建**：App"创建库存盘点凭证-常规库存"（按工厂+仓储地点批量）。
标准步骤参见 `KB_SC/KB_MM_BML_Physical-Inventory.md`。
### 8.2 盘点后 OMS 同步
盘点结果过账后，OMS 将 SAP 库存数量同步至 OMS（接口，见 `集成约定.md`）。来源：蓝图 BP-06-008。
---
## 九、主数据特例
- **物料主数据**：创建细节见 物料管理操作手册 §2（外部给号时填号，内部给号不填；成品 CV 箱、单盒 EA；批次类 ZYDY_CP/ZYDY_YL/KG_桶；MRP 类型 PD；特殊采购 30 委外；外部采购存储地点 A101-A107）。
- **供应商主数据**：App"维护业务伙伴"；供应商角色维护采购组织、供应商（财务会计）维护公司代码；**基于收货的发票校验默认打勾**。
- **采购信息记录**：App"管理采购信息记录"；信息类别"标准"或"外协加工"；净价/有效期/计划交货时间。
> 标准主数据流程参见 `KB_SC/KB_MASTERDATA_Material.md`、`KB_SC/KB_MASTERDATA_Supplier.md`；真实值见 `组织与主数据_真实值.md`。
---
## 十、已知问题/踩坑
- 双单位物料（KG 基本计量/桶附加数据）收货时**必须维护双单位比例**，否则库存数量错误（蓝图 BP-06-009 步骤 8 强调）。
- 委外/拆装包子件**含批次时必须传子件消耗量**（接口），否则按标准比例扣减会出错。
- 拆装包收货不用自定义移动类型 Z10 会**误入质检流程**。
- 费用类采购不勾"无价值收货"会错误产生库存。
- 退货采购订单不勾"退货"会导致无法正确过账。
> 详见 `上线问题记录.md` 和 `未决问题清单.md`。
---
*操作特例_MM_采购仓储.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 物料管理操作手册 | MM操作手册V1.5 |
| 物料凭证接口设计记录 | 移动类型-物料凭证创建_V1.0 |
| 接口测试记录 | 接口测试文档 MM |
| 盘点操作手册 | ES盘点手册 |
| 数据规则约定 | 数据规则说明文档 |
| 业务测试脚本 | SAP-UIT-01 |
| 接口开发负责人 | 李宝旭 |
KB_一甸园/操作特例_PP_QM_生产质量.md 0 → 100644
View file @ 346d2f11
# 操作特例_PP_QM_生产质量
> **文档类型**：项目 KB — PP/QM 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：业务测试脚本（2023-11）、质检业务流程约定、蓝图 BP-05/07、物料管理操作手册
---
## 一、实施 Scope Item 清单
| Scope Item ID | 名称 | 一甸园用法 | Base KB 引用 |
|--------------|------|-----------|-------------|
| J44 | Material Requirements Planning | 独立需求计划+MRP | `KB_SC/KB_MM_J44_Material-Requirements-Planning.md` |
| BJN | Rework Stock Manufactured | 退换货换料/拆装包（联合 MM） | `KB_SC/KB_PP_BJN_Rework-Stock-Manufactured.md` |
| 1E1 | Quality in Discrete/Process Mfg | 委外成品质检 | `KB_SC/KB_QM_1E1_Quality-in-Discrete-and-Process-Manufacturing.md` |
| 1FM | Quality in Procurement | 原材料质检 | `KB_SC/KB_QM_1FM_Quality-in-Procurement.md` |
| 1MR | Quality in Stock Handling | 拆装包/移库质检绕过 | `KB_SC/KB_QM_1MR_Quality-in-Stock-Handling.md` |
> ⚠️ **一甸园不启用**：BJ8（Make-to-Stock Process）、BJ5（Discrete）、BJH（Repetitive）等厂内工单 Scope Item——生产全部委外（见 `蓝图决策记录.md` PP-02）。
---
## 二、PP — 计划业务特例
### 2.1 生产模式确认
**一甸园不做厂内生产**：无生产订单、无厂内工序报工。生产链路 = 独立需求计划 → MRP → 委外采购订单（ZY2）→ 代工厂生产 → 委外收货。计划是 PP 唯一落地点。
### 2.2 计划高频路径（业务测试脚本）
| 步骤 | 操作 | 关键用户 | 输入内容（真实值） |
|------|------|---------|-------------------|
| 1 | 创建独立需求计划 MD61 | 张仁玲 | 公司代码 **A100**、工厂 **A101**、MRP 范围 **A101**、期间类型 D 日/W 月、日期区间 |
| 2 | 修改独立需求计划 MD62 | 张仁玲 | 同上 |
| 3 | 显示独立需求计划 MD63 | 张仁玲 | 同上 |
| 4 | 维护 PIR（计划独立需求） | 张仁玲 | 工厂 A101、期间类型 M 月 |
| 5 | 计划 MRP/管理物料覆盖范围 | 张仁玲 | 短缺定义：物料需求计划标准；物料：YDY03 YDY02 YDY01；工厂 A101 |
| 6-9 | 处理采购申请→创建/更改/显示采购订单 | 采购部 | ME21N/ME22N/ME23N（采购订单 4500000491 等） |
| 10 | 配料（过账货物移动 541） | 仓库 | 传输过账-采购订单 |
| 11 | 收货/耗料（101+543） | 仓库 | 收货-采购订单 |
| 12 | 预制供应商发票 MIRO | 采购部 | 日期、金额 |
> ⚠️ 测试脚本中的 MD61/62/63、ME21N、MIGO、MIRO 为 OP 事务码，Cloud 等价 App 见 `KB_SC/KB_REFERENCE_OPOnly_Tools.md`（如 MIGO→Manage Stock/过账货物移动）。真实值（A100/A101/MRP 范围 A101）来自业务测试脚本（2023-11）。
### 2.3 计划参数（物料主数据 MRP 视图，来自 物料管理操作手册）
| 视图 | 字段 | 真实值 |
|------|------|--------|
| MRP1 | MRP 类型 | PD |
| MRP1 | MRP 控制者 | A11（A101 工厂）/ A21（A201 销售工厂） |
| MRP1 | 批量确定程序 | EX（按批订货量）/ TB（日采购量） |
| MRP2 | 采购类型 | F |
| MRP2 | 特殊采购 | 委外选 30（成品） |
| MRP2 | 外部采购存储地点 | A101 原料仓/A102 包材仓/A103 成品仓/A104 天津/A105 无锡/A106 昆山/A107 上海 |
| MRP3 | 期间标识 | W |
| MRP3 | 策略 | 10 |
| MRP3 | 消耗模式 | 2（向后/向前消耗） |
| MRP4 | 无需填写 | — |
### 2.4 拆装包（云仓）计划
拆装包走**拆装包委外订单 ZY5**（计划专员张仁玲创建），组件集中输入，收货走自定义移动类型 Z10。详见 `操作特例_MM_采购仓储.md` §四。
---
## 三、QM — 质量检验特例
### 3.1 质检主数据（BP-07-001，代进强维护）
| 步骤 | 操作 | 说明 |
|------|------|------|
| 1 | 编辑代码组 QS41 | 创建检验种类的筛选范围条件 |
| 2 | 编辑所选集 QS51 | 将筛选条件绑定是否缺陷 |
| 3 | 创建取样程序 | 100% 或其他规则 |
| 4 | 创建主检验特征 | 创建检验种类并分配上述主数据 |
| 5 | 创建检验计划（QP01/QP02） | 用途 **5**、状态 **4**；绑定检验工艺/检验类型/检验方式 |
> 来源：质检业务流程约定、蓝图 BP-07-001、业务测试脚本。
### 3.2 质检高频路径（BP-07-002）
1. **入库触发检验批**：原材料采购入库 / 委外成品入库时，按行项目自动产生检验批（MIGO/过账货物移动收货自动触发）→ 2. **记录检验结果**（代进强，App"记录检验结果"，QE01 等价）→ 3. **管理使用决策**（代进强，App"管理使用决策"，QA11 等价）。
标准步骤参见 `KB_SC/KB_QM_1FM_Quality-in-Procurement.md §检验批处理`、`KB_SC/KB_QM_1E1_Quality-in-Discrete-and-Process-Manufacturing.md §检验批处理`。
⚠️ 一甸园特例：
- **检验类型 01**（收货检验）；控制码 QM01。
- 收货后物料进入**质量检验库存**（可用 QA03/MMBE 确认）。
- **成品质检仅上传质检报告**（蓝图标注），不等同全检流程。
### 3.3 拆装包绕过质检（关键）
因启用 QM，拆装包/移库等内部流转收货**必须使用顾问自定义移动类型**（Z10），否则进入质检流程。来源：蓝图 BP-05-003/004、`操作特例_MM_采购仓储.md` §四。
### 3.4 退货来料检验
电商/B2B 退货物料需质量部（代进强）判断能否二次销售；不能二次销售的报废或其他处理（移动类型 551/955 等，见 `操作特例_MM_采购仓储.md` §七）。
---
## 四、主数据（业务测试脚本 确认）
| 步骤 | 操作 | 关键用户 | 说明 |
|------|------|---------|------|
| 1-2 | 维护/更改物料 | 代进强 | MM01/MM02（Cloud：管理产品主数据） |
| 3-4 | 维护/更改物料清单 BOM | 代进强 | CS01/CS02 |
| 5 | 管理生产版本 | 代进强 | C223（Cloud：管理生产版本） |
> ⚠️ 物料/BOM/生产版本责任人为**代进强**（质量部），非计划部——与常见分工不同（蓝图 BP-07-001 确认）。
---
## 五、关键提示
- 计划部负责人：张仁玲（MRP 控制者 A11 实际操作人）。
- 质检负责人：代进强（唯一质检操作人）。
- 一甸园成品有 BOM 与生产版本（委外配料/收货依据），原料按批次管理。
- 委外子件含批次时收货必须传消耗量（见 `操作特例_MM_采购仓储.md` §三）。
---
*操作特例_PP_QM_生产质量.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 业务测试脚本（2023-11） | 测试脚本 SAP-UIT-01/04（20231112）／SAP_M3_业务测试脚本_20231112_V1.0 |
| 业务测试脚本 | SAP-UIT-01／SAP-UIT-04 |
| 质检业务流程约定 | 质检业务流程文档 |
| 物料管理操作手册 | MM操作手册V1.5 |
KB_一甸园/操作特例_SD_销售.md 0 → 100644
View file @ 346d2f11
# 操作特例_SD_销售
> **文档类型**：项目 KB — SD 操作特例
> **用途**：记录与 SC Base KB 标准不同的部分 + 高频操作完整路径（含真实值）。**标准步骤不重写，只引用 Base KB。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：蓝图 BP-01~04、接口确认记录 V1.1（2024-04-08）、数据规则约定 §3.3-3.5
---
## 一、实施 Scope Item 清单
| Scope Item ID | 名称 | 一甸园用法 | Base KB 引用 |
|--------------|------|-----------|-------------|
| BD9 | Sell from Stock | B2B 标准销售订单 OR | `KB_SC/KB_SD_BD9_Sell-from-Stock.md` |
| BDD | Lean Customer Returns | B2B/B2C 退货 | `KB_SC/KB_SD_BDD_Lean-Customer-Returns.md` |
| BKP | Customer Returns | 换货退货 | `KB_SC/KB_SD_BKP_Customer-Returns.md` |
| 1HO | Intercompany Sales Domestic | 跨公司销售（A200→A100） | `KB_SC/KB_SD_1HO_Intercompany-Sales-Domestic.md` |
| BDA | Free of Charge Delivery | 样品赠送（免费订单 CBFD） | `KB_SC/KB_SD_BDA_Free-of-Charge-Delivery.md` |
| 1EZ | Credit Memo Processing | 仅退款/贷项凭证 | `KB_SC/KB_SD_1EZ_Credit-Memo-Processing.md` |
| BDH | One-Time Customer | 虚拟客户（电商） | `KB_SC/KB_SD_BDH_One-Time-Customer.md` |
| BJN | Rework Stock Manufactured | 退换货换料 | `KB_SC/KB_PP_BJN_Rework-Stock-Manufactured.md`（联合引用） |
---
## 二、B2B 销售（标准订单 OR）
### 高频路径（真实流程）
1. 渠道销售线下报价（协议价含运费）→ 2. 查询库存（OMS）→ 3. 接收订单（邮件/微信）→ 4. 若新客户创建客户主数据（鲁倩倩，App"维护业务伙伴"）→ 5. 创建价格清单（鲁倩倩，App"管理价格"）→ 6. 创建标准销售订单 OR（洪飞）→ 7. 价格确认（折扣额/单价/计提/运费特殊价格条件手工录入）→ 8. **销售经理+财务审批**（陶灵峰、鲁玖贤）→ 9. 若有预收款创建客户预付款申请（洪飞）→ 10. 创建外向交货单（洪飞，调整发货地址/数量，批次指定/自提写备注）→ 11. 出库单同步 OMS → 12. 物流找车（胡明星）→ 13. 云仓实物发货 → 14. **OMS 调 SAP 交货过账接口自动发货过账** → 15. 系统推送过账邮件 → 16. 财务创建并审批形式发票（鲁玖贤）。
标准步骤参见 `KB_SC/KB_SD_BD9_Sell-from-Stock.md §销售订单创建/外向交货/发货过账`。
⚠️ 一甸园特例：
- **订单审批**：销售经理（陶灵峰）+ 财务（鲁玖贤）双人审批，Standard 无此强制步骤。
- **交货过账由 OMS 接口触发**（非人工），见 `集成约定.md` 接口 3。
- 销售订单额外字段：传 SAP 时若有值传字段值，无则传默认值（中台方案设计）。
### 2.1 客户主数据
- 账户组：C001 线上客户 / C002 经销商 / C003 直营店 / C004 客户送货地址（见 `组织与主数据_真实值.md` §3.5）。
- ⚠️ 电商客户不同步 OMS：**虚拟客户管理**，订单同步发货地址，OMS 将信息同步云仓发货。来源：中台方案设计 §主数据管理。
---
## 三、B2C 电商销售（自动链路）
### 高频路径
1. 网店下单（抖音/天猫/京东/拼多多/有赞/视频号/快团团/京东自营/天猫超市）→ 2. OMS 抓单 → 3. 制单员改单（洪飞，赠品等特殊情况）→ 4. 出库信息同步云仓 → 5. 云仓揽收发货 → 6. 中台同步结算系统 → 7. **中台自动生成 SAP 销售订单** → 8. **自动生成外向交货单并过账发货** → 9. **自动创建 SAP 形式发票**。
> 来源：蓝图 BP-01 步骤 1-11。SAP 侧不手工创建电商销售订单。
> ⚠️ 特例：B2C 销售/退货接口需**物料转换逻辑**（OMS 编码→SAP 物料号），固定一个店铺按物料品牌存店铺编码（中台方案设计 §B2C销售）。
### 3.1 私域平台
制单员从私域平台导出 EXCEL → 手工导入 OMS → 后续同电商链路。来源：蓝图 BP-02-004。
---
## 四、电商退货三场景
### 4.1 整单退货（BP-02-001）
1. 客户网店发起退货退款 → 2. OMS 生成售后单 → 3. 云仓退货收货（反馈实际收货数量）→ 4. 质量部物料检验（代进强，判断能否二次销售，不能则报废）→ 5. 结算系统同步 → 6. **SAP 自动生成退货单、退货入库单并过账、退货贷项凭证（红冲发票）**。
⚠️ 特例：客户部分退货时 OMS 无法修改退货单位 → 会导致回传 SAP 数据出错（蓝图 BP-02-001 步骤 4 标注）。
### 4.2 退换货（BP-02-002）
1. 客户退换货售后 → 2. OMS 状态更改 → 3. 客服线下登记换货（共享 Excel）→ 4. 计划专员创建退货单（张仁玲）→ 5. 云仓收货确认 → 6. 接口同步退货信息 → 7. 物料检验（代进强）→ 8. 制单员查询物流/收货（洪飞）→ 9. OMS 手动创建补货单（洪飞）→ 10. 云仓发货 → 11. **SAP 生成退货单、退货发货单、换货订单、换货发货**。
### 4.3 仅退款（BP-02-003）
1. 客户仅退款 → 2. OMS 售后单 → 3. 快递拦截（洪飞，货物已出库时）→ 4. 结算系统同步 → 5. **SAP 生成贷项凭证申请和贷项凭证（红冲形式发票退款）**。
标准退货步骤参见 `KB_SC/KB_SD_BDD_Lean-Customer-Returns.md`、`KB_SC/KB_SD_1EZ_Credit-Memo-Processing.md`。
---
## 五、B2B 销售退货/退换货/样品赠送
### 5.1 退货（BP-03-001）
1. 销售接收退货信息（原因/数量/金额/批次）→ 2. 邮件告知制单员 → 3. 创建退货订单（洪飞，能确定来源参考创建，无头单直接创建）→ 4. 销售经理+财务审批（陶灵峰、鲁玖贤）→ 5. 系统自动创建退货入库单 → 6. 同步 OMS → 7. 云仓收货确认 → 8. **OMS 调 SAP 退货接口自动过账入库** → 9. 物料检验（代进强）→ 10. 财务创建并审批形式发票（鲁玖贤）。
### 5.2 退换货（BP-03-002）
退货链路同上（计划专员张仁玲创建退货入库单填物流单号）→ 11. 制单员创建换货订单（洪飞，附加运费用其他凭证收取）→ 12. 审批 → 13. 创建换货交货单 → 14. 同步 OMS → 15. 物流找车（胡明星）→ 16. 云仓发货 → 17. **OMS 调 SAP 发货接口自动过账** → 18. 财务创建形式发票。
> ⚠️ 换货退货物料默认**冻结状态**（移动类型 423E 冻结→非限制，带销售订单）。见 `操作特例_MM_采购仓储.md` §七。
### 5.3 样品赠送（BP-03-003）
1. 销售员钉钉申请样品 → 2. 销售经理+财务审批（陶灵峰、鲁玖贤）→ 3. 制单员导入 OMS（洪飞）→ 4. 云仓发货 → 5. 中台同步 → 6. **SAP 成本中心出库过账**（免费订单 CBFD）。
标准步骤参见 `KB_SC/KB_SD_BDA_Free-of-Charge-Delivery.md`。
⚠️ 一甸园特例：样品按**成本中心出库**处理（不确认收入），免费订单类型 CBFD（0020 段）。
---
## 六、跨公司销售（A200 卖、A101 发货）
### 高频路径（BP-04）
1. 客户在上海一甸园销售公司（A200）网店（小红书）下单 → 2. OMS 抓单 → 3. 制单员改单（洪飞）→ 4. 同步云仓 → 5. 云仓揽收发货 → 6. 中台整合 → 7. **自动生成 A200 销售订单** → 8. **自动生成外向交货单并过账** → 9. **自动生成三张凭证**：A200 对客户应收形式发票 + A100 对 A200 应收形式发票 + A200 对 A100 付款凭证。
标准步骤参见 `KB_SC/KB_SD_1HO_Intercompany-Sales-Domestic.md`。
⚠️ 一甸园特例：
- 跨公司销售发货工厂 **A201**（销售工厂成品仓），供货公司 A100 工厂 A101。
- 会计处理为 A100→A200→客户 逐级开票（蓝图 BP-04 步骤 10 说明）。
---
## 七、单据类型对照表（一甸园）
| 业务 | 销售订单类型 | 编号段 | 交货单 | 发票类型 |
|------|------------|--------|--------|---------|
| 标准销售 | OR | 0010000000-0014999999 | LF（0080 段） | F2 发票 |
| 样品赠送 | CBFD | 0020000000-0024999999 | LF | —（成本中心出库） |
| 退货 | CBRE | 0030000000-0034999999 | LR（0084 段） | CBRE 退货贷项凭证 |
| 换货交货 | SD2 | 0040000000-0044999999 | LR2 | — |
| 借项凭证请求 | DR | 0050000000-0054999999 | — | L2 借项凭证 |
| 贷项凭证请求 | CR | 0060000000-0064999999 | — | G2 贷项凭证 |
| 换货退货单 | CBAR | 0070000000-0074999999 | — | S1/S2 作废 |
> 来源：数据规则约定 §3.3-3.5。完整编号段见 `组织与主数据_真实值.md` §四。
---
## 八、关键操作提示
- 交货单过账**特别注意实际发货日期**（涉及财务），批次物料需填批次。
- 发货过账冲销：App"冲销发货-出库交货"，注意冲销日期。
- B2B 订单价格确认：计提/运费等特殊价格条件需手工录入（蓝图 BP-03 步骤 7）。
- 电商/跨公司订单由接口自动生成，**禁止手工创建**。
---
*操作特例_SD_销售.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 接口确认记录 V1.1 | 接口确认文档 V1.1 |
| 数据规则约定 | 数据规则说明文档 |
| 中台方案设计 | OMS 方案设计 |
KB_一甸园/未决问题清单.md 0 → 100644
View file @ 346d2f11
# 未决问题清单
> **文档类型**：项目 KB — 待确认/未决事项
> **用途**：列出尚需客户/顾问确认的事项，防止重复询问、留作知识缺口。**每条必须给"当前状态 + 待确认点 + 依据来源"。**
> **版本**：v1.0 | 2026-08-17
> **主要来源**：蓝图、业务分工表（2024-03-20）、项目周报待确认事项、中台方案设计、接口测试记录
---
## 一、主数据类
| # | 问题 | 当前状态 | 待确认点 | 来源 |
|---|------|---------|---------|------|
| M1 | OMS 物料一物多码（版本问题）是否在期初合并 | 期初盘点未到批次级；是否合并未定 | 期初库存按 OMS 现有编码导入还是合并后 SAP 编码导入；合并规则由谁定 | 项目周报"待确认事项"第 2 条 |
| M2 | DNEW 老库存如何处理 | 未定 | 是否迁移、冲销科目、调整时点 | 项目周报"待确认事项"第 1 条（12 月末盘点未到批次级） |
| M3 | 配料负责人（代工厂外包业务） | 蓝图阶段确认负责人：代进强；会议记录仍"待确认" | 最终确认人，操作范围（配料过账权限） | 业务分工表第 6 项 |
| M4 | 创建维护物料/BOM/生产版本负责人 | 蓝图阶段确认负责人：代进强；会议记录仍"待确认" | 最终确认人 | 业务分工表第 11 项 |
| M5 | 天香代工厂库存管理归属 | 未定 | 谁管（盘点/日常收发） | 业务分工表第 10 项备注 |
## 二、流程/审批类
| # | 问题 | 当前状态 | 待确认点 | 来源 |
|---|------|---------|---------|------|
| P1 | 云仓采购退换货、费用类采购 | 尚未实际操作 | 操作规范、财务费用类采购规则 | 业务分工表第 3/4 项 |
| P2 | 寄样出库操作 | 尚未实际操作 | 流程确认、执行人（代进强） | 业务分工表第 5 项 |
| P3 | 云仓退货收货方式 | 未定 | B2B 退货"使用采购入/售后单"方式需与仓库确认 | 中台方案设计 §B2B销售退货 |
| P4 | 中台新物料上线分类管理 | 已定（分类在 SAP 管理） | 操作归属确认（物料主数据由谁负责） | 中台方案设计 §主数据管理 |
## 三、接口类
| # | 问题 | 当前状态 | 待确认点 | 来源 |
|---|------|---------|---------|------|
| I1 | 部分退货时 OMS 无法修改退货单位，回传 SAP 数据出错 | 待确认 | 部分退货单位不一致时如何处理（人工核对实际收货数量） | 中台方案设计 §B2B销售退货 |
| I2 | 调拨出库/入库跨月时数据传输后 SAP 需人工调整 | 待确认 | 跨月调整操作规范 | 中台方案设计 §调拨业务 |
| I3 | 成本中心出入库接口（9/10）有功能变动 | 2024.4.19 切换 | 变动内容确认后切换 | 接口确认记录 V1.1 |
| I4 | 物流箱出库接口（11-1）测试 | 测试完毕后切换 | 测试通过状态 | 接口确认记录 V1.1 |
| I5 | 销售寄样单接口频率与状态 | 已切换 | 运行稳定性 | 接口确认记录 V1.1 |
## 四、数据类
| # | 问题 | 当前状态 | 待确认点 | 来源 |
|---|------|---------|---------|------|
| D1 | 组件消耗按标准损耗率 | 已定 | 标准损耗率值维护确认 | 项目周报"待确认事项"第 3 条 |
| D2 | 财务科目余额按新科目表调整分配 | 已提供 | 新旧科目对照关系备查确认 | 项目周报动态数据第 4 项 |
| D3 | 采购未清单据（已下单未收货等 4 类） | 暂未确认（请假） | 补录完成确认（接口打通前置条件） | 项目周报动态数据 |
---
## 使用说明
- 本清单随项目进展更新：已解决条目移入 `蓝图决策记录.md` 或 `上线问题记录.md` 并标注解决日期。
- 顾问在遇到客户提问时，先查本清单；清单内条目**不得凭空作答**，应引用"待确认点"并引导客户决策。
- 新增未决事项按分类追加，保持编号连续。
---
*未决问题清单.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 业务分工表 | 业务线分工表 |
| 项目周报 | 周报 |
| 中台方案设计 | OMS 方案设计 |
| 接口测试记录 | 接口测试文档 |
| 接口确认记录 V1.1 | 接口确认 V1.1 |
KB_一甸园/组织与主数据_真实值.md 0 → 100644
View file @ 346d2f11
# 组织与主数据_真实值
> **文档类型**：项目 KB — 真实值参考
> **用途**：SC Agent 操作前**必须**先查此文件，用真实组织码/主数据编号替换 SC Base KB 中的占位值（如组织 1310、客户 13100003）。
> **版本**：v1.0 | 2026-08-17
---
## 一、组织结构表（全部为客户真实值）
### 1.1 公司代码 / 控制范围 / 经营组织
| 组织单元 | 编码 | 描述 | 来源 |
|---------|------|------|------|
| 经营组织 | A000 | 一甸园经营范围 | 数据规则约定 §1.1 |
| 控制范围 | A000 | 一甸园控制范围 | 数据规则约定 §1.2 |
| 会计科目表 | YCOA | 一甸园会计科目表 | 数据规则约定 §1.3 |
| 公司代码 | **A100** | 一甸园饮料（上海）有限公司 | 数据规则约定 §1.4 |
| 公司代码 | **A200** | 上海一甸园饮料销售有限公司 | 数据规则约定 §1.4 |
> A100 = 生产/采购主体；A200 = 销售公司主体（跨公司销售场景，见 `操作特例_SD_销售.md` §跨公司销售）。
### 1.2 工厂与库存地点
| 公司代码 | 工厂 | 工厂名称 | 库存地点 | 描述 | OMS 仓库代码 | 备注 |
|---------|------|---------|---------|------|-------------|------|
| A100 | **A101** | 一甸园工厂 | A101 | 原材料仓 | — | |
| | | | A102 | 包材仓 | — | |
| | | | A103 | 成品仓 | — | |
| | | | A104 | 天津云仓 | 022-002C | 货主编号 CS230846，景天 WMS |
| | | | A105 | 无锡云仓 | 510-002C | 货主编号 CS230846，景天 WMS |
| | | | A106 | 昆山云仓 | 0033 | 货主编号 SHYIDIANYUANWDT，旺店通 WMS |
| | | | A107 | 上海仓 | — | |
| A200 | **A201** | 销售工厂 | A201 | 成品仓 | — | 跨公司销售发货工厂 |
> 来源：数据规则约定 §1.7-§1.8。工厂/库存地点为 4 位编码，规则"公司编码前 2 位 + 流水码"。
### 1.3 采购组织 / 采购组
| 采购组织 | 描述 | 采购组 | 描述 |
|---------|------|--------|------|
| **A101** | 一甸园采购组织 | 101 | 供应链采购组 |
| **A201** | 一甸园销售采购组织 | 102 | 工厂采购组 |
| | | 201 | 销售公司采购组 |
> 来源：数据规则约定 §1.9-§1.10。
### 1.4 销售组织 / 分销渠道 / 产品组 / 装运点 / 销售地区 / 销售部门 / 销售组
| 组织单元 | 编码 | 描述 |
|---------|------|------|
| 销售组织 | **A100** | 一甸园饮料销售组织 |
| 销售组织 | **A200** | 上海一甸园饮料销售组织 |
| 分销渠道 | 10 | 通用分销渠道（全渠道唯一） |
| 产品组 | 00 | 通用产品组 |
| 装运点 | 1000 | 一甸园标准装运点 |
| 销售地区 | CN0001-CN0005 | 北/南/西/东/中部 |
| 销售部门 | A101 | A100销售部 |
| 销售部门 | A201 | A200销售部 |
| 销售组 | 100 / 101 / 102 | 销售员张 / 李 / 王 |
> 来源：数据规则约定 §1.11-§1.17。
---
## 二、利润中心与成本中心
### 2.1 利润中心（规则：公司编码 + 三位流水码）
| 编码 | 描述 | 编码 | 描述 |
|------|------|------|------|
| A100000 | 公共 | A100109 | 京东自营 |
| A100101 | 天猫旗舰店 | A100110 | 天猫超市 |
| A100102 | 抖音旗舰店 | A100111 | 电商分销（除天猫超市和京东自营） |
| A100103 | 京东旗舰店 | A100201-207 | 华东/华南/华西/华北/华中/餐饮/其他线下 |
| A100104 | 淘宝品牌店 | A100206 | 餐饮渠道 |
| A100105 | 拼多多旗舰店 | A100207 | 其他线下渠道 |
| A100106 | 有赞一甸园Edenfarm | A200001 | 小红书旗舰店（A200 公司） |
| A100107 | 微信视频号旗舰店 | A100108 | 快团团 |
> 来源：数据规则约定 §1.5。利润中心与实际电商渠道一一对应，用于渠道损益分析。
### 2.2 成本中心（费用归集最小单元）
**编码规则**：7-10 位；公司码 + 部门流水；功能范围 YB40 管理 / YB10 销售 / YB50 研发 / YB20 生产。
| 成本中心 | 名称 | 类型 | 功能范围 | 公司 |
|---------|------|------|---------|------|
| A1000100 | 总经办 | L管理 | YB40 | A100 |
| A1000200 | 市场部 | L | YB40 | A100 |
| A1000301 | 质量部 | L | YB40 | A100 |
| A1000302 | 仓库物流部 | L | YB40 | A100 |
| A1000303 | 生产计划部 | L | YB40 | A100 |
| A1000304 | **采购部** | L | YB40 | A100 |
| A1000305 | 供应链管理 | L | YB40 | A100 |
| A1000400 | 研发部 | E研发 | YB50 | A100 |
| A1000500 | 财务部 | L | YB40 | A100 |
| A1000600 | 人事部 | L | YB40 | A100 |
| A1000700 | IT部 | L | YB40 | A100 |
| A1000811-820 | 各电商渠道销售（天猫/抖音/京东/淘宝/小红书/有赞/视频号/快团团/京东自营/电商分销） | V销售 | YB10 | A100 |
| A1000821-827 | 各大区/餐饮/其他线下 | V | YB10 | A100 |
| A1000900 | 生产部 | F生产 | YB20 | A100 |
| A2000100 | 销售部 | V | YB10 | A200 |
> 来源：数据规则约定 §1.6。
> ⚠️ 高频使用：**A1000304 采购部**（成本中心领料 201/202 过账对象，见 `操作特例_MM_采购仓储.md`）、**A1000302 仓库物流部**。
---
## 三、主数据编号规则
### 3.1 物料主数据
**物料类型**（大类，内部给号，5 位流水）：
| 大类编码 | 物料类型代码 | 名称 | 编码范围 | 计量单位 |
|---------|------------|------|---------|---------|
| 1 | **Z001** | 成品 | 100000-199999 | CV 箱（单盒 EA/BOX） |
| 2 | **Z002** | 原料 | 200000-299999 | KG |
| 3 | **Z003** | 生产辅材 | 300000-399999 | EA |
| 4 | **Z004** | 履约包材 | 400000-499999 | EA |
| 5 | **Z005** | 赠品周边 | 900000-999999 | EA |
> 来源：数据规则约定 §2.4。物料主数据创建细节见 `物料管理操作手册`（批次类、销售/采购/MRP 视图参数）。
**物料组**：101-108 成品（柳叶包番茄汁/蔬菜汁/胡萝卜汁/橙子味/蓝莓味/葡萄味果蔬汁/玻璃瓶番茄汁/组合装）、201 原料、301-304 生产辅材（内包/纸箱/吸管/周转箱）、401-402 履约包材（物流箱/其他）、501 赠品周边。
### 3.2 批次规则
| 对象 | 规则 | 示例 |
|------|------|------|
| 成品 | 委外工厂首字母 + 8 位日期 | `C20231107` |
| 原料 | 6 位日期 + 3 位箱规 | `231107200` |
> 来源：数据规则约定 §2.6。批次类：ZYDY_CP（成品）、ZYDY_YL（原料）、KG_桶（原料附加数据，测量单位用法 B）。
### 3.3 供应商主数据（内部给号）
| 供应商分组 | 名称 | 编码范围 |
|-----------|------|---------|
| Z001 | 原浆供应商 | 0050000000-0059999999 |
| Z002 | 生产辅材供应商 | 0060000000-0069999999 |
| Z003 | 其他供应商 | 0070000000-0079999999 |
| Z004 | 员工（一甸园） | 0080000000-0089999999 |
> 来源：数据规则约定 §2.7。
### 3.4 供应商物料税分类
| 编码 | 描述 | 税率 |
|------|------|------|
| J0 | 固定资产-进项税 0% | 0% |
| J1 | 固定资产-进项税 13% | 13% |
| J2 | 固定资产-进项税 9% | 9% |
| J3 | 固定资产-进项税 6% | 6% |
| J4 | 固定资产-进项税 3% | 3% |
| J5 | 固定资产-进项税 1% | 1% |
### 3.5 客户主数据（内部给号）
| 客户账户组 | 名称 | 编码范围 |
|-----------|------|---------|
| C001 | 线上客户 | 0010000000-0019999999 |
| C002 | 经销商 | 0020000000-0029999999 |
| C003 | 直营店 | 0030000000-0039999999 |
| C004 | 客户送货地址 | 0040000000-0049999999 |
**客户组**：组1 A01 电商销售 / A02 线下销售 / A03 其他；组2 B01 电商零售 / B02 电商分销 / B03 商超渠道 / B04 餐饮渠道 / B05 其他渠道。组3-5（C01/C02、D01/D02、E01/E02）待维护。
**客户物料税分类**：X0 销项税 0%、X1 销项税 13%。
### 3.6 价格主数据（条件类型）
| 条件类型 | 描述 | 类别 |
|---------|------|------|
| ZPR0 | 指导价 | 价格 |
| ZPR1 | 标准价 | 价格 |
| ZPR2 | 应收价 | 价格 |
| ZPB1 | 折扣费 | 折扣 |
| ZPB2 | 客户折扣（百分比） | 折扣 |
| PCIP | 成本价 | 成本 |
| DRV1 | 折扣额 | 折扣 |
| ZTX1 | 销项税 | 税额 |
### 3.7 MRP 控制者
| 工厂 | MRP 控制者 | 描述 |
|------|-----------|------|
| A101 | **A11** | 计划员（一甸园工厂） |
| A201 | **A21** | 计划员（销售工厂） |
> 来源：数据规则约定 §2.11。责任人：张仁玲（计划，见 `00_项目概况.md`）。
---
## 四、单据类型与编号范围（全部内部给号）
### 4.1 采购申请
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| ZY1 | 库存类采购申请 | 6000000000-6099999999 |
| ZY2 | 委外类生产申请 | 6100000000-6199999999 |
| ZY3 | 资产类采购申请 | 6200000000-6299999999 |
| ZY4 | 费用类采购申请 | 6300000000-6399999999 |
| ZY5 | 拆装包类申请 | 6400000000-6499999999 |
| ZY6 | 退货类采购申请 | 6500000000-6599999999 |
### 4.2 采购订单
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| ZY1 | 库存类采购订单 | 9000000000-9099999999 |
| ZY2 | 委外类生产订单 | 9100000000-9199999999 |
| ZY3 | 资产类采购订单 | 9200000000-9299999999 |
| ZY4 | 费用类采购订单 | 9300000000-9399999999 |
| ZY5 | 拆装包类订单 | 9400000000-9499999999 |
| ZY6 | 退货类采购订单 | 9500000000-9599999999 |
| **UB** | 库存转储订单 | 4500000000-4599999999 |
### 4.3 销售订单
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| OR | 标准销售订单 | 0010000000-0014999999 |
| CBFD | 免费订单（样品赠送） | 0020000000-0024999999 |
| CBRE | 退货订单 | 0030000000-0034999999 |
| SD2 | 换货交货单 | 0040000000-0044999999 |
| DR | 借项凭证请求 | 0050000000-0054999999 |
| CR | 贷项凭证请求 | 0060000000-0064999999 |
| CBAR | 换货退货单 | 0070000000-0074999999 |
### 4.4 交货单
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| LF | 出库交货 | 0080000000-0083999999 |
| LR | 退货交货单 | 0084000000-0084999999 |
| LR2 | 换货退货 | 0084000000-0084999999 |
### 4.5 发票
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| F2 | 发票 | 0090000000-0094999999 |
| S1 | 发票作废 | 0090000000-0094999999 |
| CBRE | 退货贷项凭证 | 0090000000-0094999999 |
| G2 | 贷项凭证 | 0090000000-0094999999 |
| S2 | 贷项凭证取消 | 0090000000-0094999999 |
| L2 | 借项凭证 | 0090000000-0094999999 |
> 来源：数据规则约定 §3.1-§3.5。
---
## 五、关键主数据真实值（高频使用）
### 5.1 成品物料（来自生产物料 BOM + 产品映射表）
| SAP 物料号 | 品名 | 物料组 | 批次规则 | 单位 |
|-----------|------|--------|---------|------|
| 100009 | 橙子味果蔬汁（10 盒装） | 104 | 委外厂首字母+8位日期 | CV 箱 |
| 100010 | 橙子味果蔬汁（24 盒装） | 104 | 同上 | CV 箱 |
| 100012 | 蓝莓味果蔬汁 | 105 | 同上 | CV 箱 |
| 100013 | 蓝莓味果蔬汁 | 105 | 同上 | CV 箱 |
| 100000 | 番茄汁 200ml*10 | 101 | 同上 | CV 箱 |
### 5.2 原料物料（部分）
| SAP 物料号 | 品名 | 供应商示例 |
|-----------|------|-----------|
| 200000 | 浓缩橙子汁 | 连晟食品科技 |
| 200001 | 苹果浓缩汁 | 连晟食品科技 |
| 200002 | 浓缩胡萝卜汁 | 金乡县金得利 |
| 200008 | 蓝莓汁 | 赤峰光合 |
| 200009 | 复合蔬菜汁（10 种） | — |
| 200011 | 番茄汁 | — |
### 5.3 包材/履约物料（部分）
| SAP 物料号 | 品名 | 备注 |
|-----------|------|------|
| 300011 | 柳叶包包材 | 生产辅材 |
| 300009 | 10 礼盒 | 生产辅材 |
| 300010 | 24 自动片 | 生产辅材 |
| 300022 | 吸管 | 生产辅材 |
| 300032/300033 | 周转箱 | 生产辅材 |
> 供应商：连晟食品科技、金乡县金得利、赤峰光合、利乐包装（北京）、河北和瑞包装。
### 5.4 会计科目 / 固定资产
- **会计科目**：10 位，财政部统一编码；一级 4 位（1XXX 资产 / 2XXX 负债 / 4XXX 权益 / 5XXX、8XXX 成本费用 / 6XXX 损益 / 9XXX 初始化）。
- **期初库存导入科目**：9001900000（期初库存导入，见 `上线问题记录.md`）。
- **固定资产**：资产类别 3300 电子设备；折旧码 CD01 直接折旧法次月折旧；5 年；残值率 5%；编码范围 33000000000-33009999999。
---
## 六、注意事项
- ⚠️ 以上均为**客户真实值**，来源为数据规则约定 V1.1（2023-11-17）、生产物料 BOM、接口测试记录。
- 蓝图/测试脚本确认的组织值：公司代码 A100、工厂 A101、MRP 范围 A101（业务测试脚本）。
- 若在系统中查到的实际值与上表不一致，以系统当前主数据为准并回写本文件，标注发现日期。
---
*组织与主数据_真实值.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 数据规则约定 V1.1 | 数据规则说明文档 V1.1 |
| 数据规则约定 | 数据规则说明文档 |
| 物料管理操作手册 | MM操作手册V1.5 |
| 接口测试记录 | 接口测试文档 MM |
| 业务测试脚本 | SAP-UIT-01 |
KB_一甸园/蓝图决策记录.md 0 → 100644
View file @ 346d2f11
# 蓝图决策记录
> **文档类型**：项目 KB — 决策依据层
> **用途**：回答"为什么这样配"和"这个功能我们用不用"。
> **版本**：v1.0 | 2026-08-17
> **主要依据**：业务蓝图方案 V1.0（2023-11-20）、数据规则约定 V1.1（2023-11-17）
---
## SD — 销售模式决策
### SD-01 电商销售通过 OMS/中台自动生成销售订单
- **决策内容**：B2C 电商（抖音/天猫/京东/拼多多/有赞/视频号/快团团/京东自营/天猫超市等）网店下单后，OMS 抓单 → 中台整合 → 自动在 SAP 生成销售订单、外向交货单并过账发货、自动创建形式发票。SAP 侧不做电商订单手工录入。
- **决策原因**：电商单量大、SKU 多、需与聚水潭/云仓联动，手工录入不现实。
- **影响范围**：SD 电商全流程；洪飞（制单员）只在 OMS 处理改单/赠品等特殊情况。
- **日期**：2023-11-20 | **负责人**：项目组（蓝图签字页）
- **依据**：蓝图 BP-01 步骤 1-11、BP-02-001~004。
### SD-02 私域平台走手工导入 OMS
- **决策内容**：私域平台（微信小程序/快团团等）由制单员从平台导出 EXCEL → 手工导入 OMS → 后续与电商同链路。
- **决策原因**：私域平台无 OMS 自动抓单接口。
- **影响范围**：私域渠道订单处理；洪飞。
- **日期**：2023-11-20 | **负责人**：洪飞 | **依据**：蓝图 BP-02-004。
### SD-03 电商退货/退换货/仅退款三场景
- **决策内容**：整单退货（BP-02-001）走"退货单+退货入库+退货贷项凭证红冲"；退换货（BP-02-002）走"退货入库→物料检验→换货订单→换货发货"；仅退款（BP-02-003）走"贷项凭证申请+贷项凭证"（1EZ）。
- **决策原因**：覆盖电商售后三类典型诉求，与结算系统/中台对接。
- **影响范围**：SD 售后全流程、FI 应收红冲、QM 退货检验（代进强）。
- **日期**：2023-11-20 | **负责人**：项目组 | **依据**：蓝图 BP-02-001~003（最佳实践 1EZ）。
### SD-04 B2B 销售走标准销售订单+审批
- **决策内容**：B2B 渠道（经销商/直营/商超/餐饮）线下报价→查询库存→创建客户（鲁倩倩）→创建价格清单（鲁倩倩）→制单员建标准销售订单（OR）→销售经理+财务审批（陶灵峰、鲁玖贤）→创建外向交货单→OMS/物流发货→自动发货过账→财务创建并审批形式发票（鲁玖贤）。
- **决策原因**：B2B 单价/折扣/运费需人工确认，必须审批流。
- **影响范围**：SD B2B、FI 应收。
- **日期**：2023-11-20 | **负责人**：洪飞/陶灵峰/鲁玖贤 | **依据**：蓝图 BP-03（最佳实践 1HO）。
### SD-05 跨公司销售（A200 卖、A101 发货）
- **决策内容**：上海一甸园销售公司（A200）在小红书等网店接单，从一甸园饮料公司（A100）工厂 A101 发货。SAP 自动生成：A200 对客户的应收形式发票 + A100 对 A200 的应收形式发票 + A200 对 A100 的付款凭证。
- **决策原因**：两法人独立核算，但实物从生产公司工厂直接发往客户，走跨公司销售。
- **影响范围**：SD 跨公司（最佳实践 1HO）、FI 应收/应付、MM 库存。
- **日期**：2023-11-20 | **负责人**：项目组 | **依据**：蓝图 BP-04。
### SD-06 样品赠送（B2B 样品 + 销售寄样）
- **决策内容**：B2B 样品赠送（BP-03-003）走钉钉申请审批→制单员导入 OMS→云仓发货→中台同步→SAP 成本中心出库过账（最佳实践 5OS、4MO）。销售寄样单独有流程（见操作特例）。
- **决策原因**：样品不计收入，按成本中心出库处理。
- **影响范围**：SD 免费订单 CBFD、MM 成本中心领料 201/202。
- **日期**：2023-11-20 | **负责人**：洪飞/陶灵峰/鲁玖贤 | **依据**：蓝图 BP-03-003。
---
## MM — 采购/仓储决策
### MM-01 采购申请/采购订单类型六分类 + UB 转储单
- **决策内容**：采购申请类型 ZY1 库存 / ZY2 委外 / ZY3 资产 / ZY4 费用 / ZY5 拆装包 / ZY6 退货；采购订单同前缀（9X 段），另设 UB 库存转储订单（4500000000 段）。
- **决策原因**：不同类型业务走不同申请/订单类型，便于统计与审批路由。
- **影响范围**：MM 采购全流程；编号规则见 `组织与主数据_真实值.md` §四。
- **日期**：2023-11-17 | **负责人**：项目组 | **依据**：数据规则约定 §3.1-3.2。
### MM-02 工厂采购 vs 云仓采购分开管理
- **决策内容**：原材料/生产辅材走**工厂 A101 采购**（MRP 驱动，BP-06-009）；履约包材/赠品周边走**云仓采购**（采购员批量创建，OMS 创建采购入库单，BP-06-010）。
- **决策原因**：两类采购目的不同（生产用料 vs 履约/促销物料），收货地点不同（工厂仓 vs 云仓 A104-A107）。
- **影响范围**：MM 收货、仓储地点、OMS 接口（采购入库单）。
- **日期**：2023-11-20 | **负责人**：胡明星 | **依据**：蓝图 BP-06-009/010。
### MM-03 委外业务（BP-05-002）
- **决策内容**：一甸园不自建生产执行（不做厂内工单），成品生产全部走**委外加工**：MRP 生成委外采购申请 ZY2 → 转委外采购订单 ZY2（9100 段）→ 审批（倪总）→ 质量员外协配料（发货至供应商库存，代进强）→ 委外收货同时消耗原料/包材（张仁玲）→ 质检（代进强）→ 预制供应商发票（加工费，胡明星）。
- **决策原因**：生产外包给代工厂，SAP 只管理委外订单与配料/收货。
- **影响范围**：PP 无工单、MM 委外订单 ZY2、QM 质检。
- **日期**：2023-11-20 | **负责人**：张仁玲/倪总/代进强/胡明星 | **依据**：蓝图 BP-05-002、BP-06-009。
### MM-04 拆装包业务（云仓）
- **决策内容**：云仓拆装包走**拆装包委外订单 ZY5（9400 段）**：计划专员创建→审批（倪总）→外协配料→云仓拆装包结果自动传 SAP 收货。移动类型使用**顾问自定义移动类型**（否则因启用 QM 会进入质检流程，见 `操作特例_MM_采购仓储.md`）。人工费用计入订单（云仓人工费）。
- **决策原因**：大包装拆小/组合装需云仓人工操作，费用需核算。
- **影响范围**：MM 拆装包 ZY5、接口（拆装 1min）、QM 质检绕过、CO 人工费。
- **日期**：2023-11-20 | **负责人**：张仁玲/倪总/胡明星 | **依据**：蓝图 BP-05-003/004。
### MM-05 库存调拨（工厂↔云仓、云仓↔云仓）
- **决策内容**：同公司库存调拨走 **UB 转储订单（4500 段）**（最佳实践 BME）。工厂→云仓：张仁玲创建 UB→胡明星发货并记录运费→中台创建 OMS 出/入库单→云仓收货→中台调 SAP 收货过账。云仓→云仓同链路。
- **决策原因**：云仓间及工厂到云仓实物需跨仓流转，且需物流运费核算。
- **影响范围**：MM 转储、接口（移库 3min）、运费核算。
- **日期**：2023-11-20 | **负责人**：张仁玲/刘亚波/胡明星 | **依据**：蓝图 BP-06-001/002（BME）。
### MM-06 成本中心领料四场景
- **决策内容**：成本中心领料按物料与地点分四场景：云仓物料（BP-06-004，走 OMS 其他出库，SAP 基于预留单自动过账 201）、工厂原料（BP-06-005，SAP 手动 201）、工厂产成品（BP-06-006，SAP 手动 201）、云仓产成品（BP-06-007，走 OMS）。移动类型 201 出库、202 入库（见 `操作特例_MM_采购仓储.md`）。
- **决策原因**：福利、客情、寄样、内部领用等非生产领料需归集到成本中心。
- **影响范围**：MM 移动类型 201/202、CO 成本中心（A1000304 采购部等）、接口（其他出库单）。
- **日期**：2023-11-20 | **负责人**：吴晓军（预留单）/需求部门 | **依据**：蓝图 BP-06-004~007。
### MM-07 盘点走标准物理盘点 + OMS 同步
- **决策内容**：财务在 SAP 发起盘点（鲁玖贤）→ 仓库输入盘点数量（刘亚波等）→ 财务接受盘点结果差异过账→ OMS 同步盘点后库存（接口）。
- **决策原因**：SAP 库存为准，OMS/云仓需同步一致。
- **影响范围**：MM 盘点（BML）、接口（库存同步）、FI 库存差异。
- **日期**：2023-11-20 | **负责人**：鲁玖贤/刘亚波 | **依据**：蓝图 BP-06-008。
### MM-08 采购退换货两场景（云仓/工厂）
- **决策内容**：云仓采购退换货（BP-02-005，最佳实践 BMK）：SAP 建退货订单（勾退货项目）→同步 OMS 建其他出库单→云仓退换货→中台调 SAP 出库过账→预制发票（仅退货时事务选"贷记凭证"）。工厂采购退换货（BP-02-006）：SAP 手动退货出库→预制发票。
- **决策原因**：云仓实物退货在 OMS 操作，工厂实物退货在 SAP 操作。
- **影响范围**：MM 退货订单 ZY6/BMK、接口（采购退货 5min）、FI 应付红冲。
- **日期**：2023-11-20 | **负责人**：胡明星 | **依据**：蓝图 BP-02-005/006。
### MM-09 供应商/物料税分类/客户税分类
- **决策内容**：供应商物料税分类 J0-J5（0%/13%/9%/6%/3%/1%）；客户物料税分类 X0（0%）、X1（13%）。
- **决策原因**：匹配不同进项/销项税率。
- **影响范围**：MM 采购、SD 销售、FI 税务。
- **日期**：2023-11-17 | **负责人**：项目组 | **依据**：数据规则约定 §2.8、§2.15。
---
## PP — 计划决策
### PP-01 计划模式：销售预测→独立需求→MRP→委外/采购申请
- **决策内容**：销售部线下预测 1 个月需求 → 计划专员（张仁玲）维护月度独立需求计划（MD61/62/63）→ 运行 MRP（公司 A100、工厂 A101、MRP 范围 A101）→ 生成委外订单与原料/包材采购申请 → 管理物料覆盖范围监控 → 调整计划。
- **决策原因**：无自建生产，计划驱动委外与采购。
- **影响范围**：PP 独立需求计划、MM 采购申请 ZY1/ZY2、委外。
- **日期**：2023-11-20 | **负责人**：张仁玲 | **依据**：蓝图 BP-05-001、BP-06-009。
### PP-02 不做厂内生产执行
- **决策内容**：不使用离散/重复制造工单（BJ5/BJ8/BJH 等 Scope Item 不启用），生产全部委外。
- **决策原因**：一甸园无自有生产线，生产在代工厂完成。
- **影响范围**：PP 范围内仅计划（独立需求/MRP/覆盖范围），无生产订单。
- **日期**：2023-11-20 | **负责人**：项目组 | **依据**：蓝图 BP-05-001/002。
---
## QM — 质量决策
### QM-01 质检覆盖：原材料采购入库 + 委外成品收货
- **决策内容**：原材料采购入库与委外生产入库时，系统按行项目自动产生检验批（移动类型含质检触发）。质量员（代进强）记录检验结果（QE01）→ 管理使用决策（QA11）。
- **决策原因**：原辅料与委外成品质量需把关。
- **影响范围**：QM 检验批、MM 收货流程（移动类型触发质检）。
- **日期**：2023-11-20 | **负责人**：代进强 | **依据**：蓝图 BP-07-002。
### QM-02 质检主数据由质量部维护
- **决策内容**：代码组（QS41 检验种类筛选）、所选集（筛选条件绑定是否缺陷）、取样程序（100% 或其他）、主检验特征、检验计划（QP01/QP02，用途 5/状态 4）由质量部（代进强）维护。
- **决策原因**：质检规则需专业质量人员配置。
- **影响范围**：QM 主数据、检验批触发。
- **日期**：2023-11-20 | **负责人**：代进强 | **依据**：蓝图 BP-07-001、质检业务流程约定。
### QM-03 拆装包业务绕过 QM（自定义移动类型）
- **决策内容**：因启用 QM 功能，拆装包收货必须使用顾问自定义移动类型，否则进入质检流程。
- **决策原因**：拆装包为内部重包，无需质检。
- **影响范围**：MM 拆装包 ZY5 收货。
- **日期**：2023-11-20 | **负责人**：接口开发负责人/顾问 | **依据**：蓝图 BP-05-003/004 步骤 4 说明。
### QM-04 退货/退换货来料检验
- **决策内容**：电商/B2B 退货实物需质量部判断能否二次销售；不能二次销售的报废或其他处理（代进强）。
- **决策原因**：保障二次销售商品质量。
- **影响范围**：SD 退货流程、QM 来料检验、MM 报废。
- **日期**：2023-11-20 | **负责人**：代进强 | **依据**：蓝图 BP-02-001/002、BP-03-001/002。
---
## FI/CO — 财务决策
### FI-01 双公司独立核算
- **决策内容**：A100 一甸园饮料（上海）有限公司 + A200 上海一甸园饮料销售有限公司两公司代码，共用控制范围 A000、会计科目表 YCOA，各自独立出法定报表。
- **决策原因**：两法人独立核算。
- **影响范围**：FI 全部、跨公司销售、内部往来。
- **日期**：2023-11-17 | **负责人**：项目组 | **依据**：数据规则约定 §1.2-1.4。
### FI-02 应付流程：预制发票→财务过账→付款申请→出纳付款
- **决策内容**：采购部（胡明星/张仁玲）预制供应商发票 → 财务（毛晓春）发票过账形成应付（GR/IR 自动清账）→ 采购部创建付款申请 → 资金主管审批 → 出纳选银行付款自动清账。
- **决策原因**：标准化应付确认与付款权限分离。
- **影响范围**：FI 应付（J60）、采购发票。
- **日期**：2023-11-20 | **负责人**：胡明星/毛晓春 | **依据**：蓝图 BP-09-001/002（J60）。
### FI-03 应收流程：形式发票→财务过账→银行回单导入→清账
- **决策内容**：销售基于交货单创建形式销售发票（洪飞）→ 应收会计过账 → 出纳导入银行回单 → 应收会计辨识收款过账 → 选择未清项清账。
- **决策原因**：标准化应收确认与收款清账。
- **影响范围**：FI 应收（J59）、SD 开票。
- **日期**：2023-11-20 | **负责人**：洪飞/鲁玖贤 | **依据**：蓝图 BP-09-003/004（J59）。
### FI-04 固定资产：资产采购两方案 + 折旧/报废/变卖/转移
- **决策内容**：固定资产采购方案一（采购订单+收货+预制发票，科目分配类别选"资产"）；方案二（先建资产卡片→资本化，集成/非集成应付）。折旧：直接折旧法（CD01），次月折旧，5 年，残值率 5%，资产类别 3300 电子设备。月结运行计划折旧。
- **决策原因**：资产类别/折旧规则符合公司财务政策。
- **影响范围**：FI 资产（J62）、MM 资产类采购申请 ZY3。
- **日期**：2023-11-20 | **负责人**：财务部 | **依据**：蓝图 BP-08-001~006（J62）、数据规则约定 §2.2。
### FI-05 员工借款/报销走钉钉审批 + SAP 记账
- **决策内容**：员工借款/报销在钉钉申请审批 → SAP 过账一般日记账分录（总账会计）。
- **决策原因**：流程在钉钉，SAP 只做财务入账。
- **影响范围**：FI 总账、CO 成本中心/其他应收应付款。
- **日期**：2023-11-20 | **负责人**：总账会计 | **依据**：蓝图 BP-09-005/006。
### FI-06 月结/年结流程
- **决策内容**：月结：检查手工单据完结→检查收付款→打开下一记账期间→运行资产折旧→GR/IR 重分类（重过账收货/收发票清账，冲销过账日期为下月 1 号）→费用分摊分配→关闭上一期间。年结：打开特殊记账期间→录入调账凭证→余额结转→开启下一资产年度→出具年度报表→关闭上一年度期间。
- **决策原因**：标准月结/年结顺序，保证结账正确性。
- **影响范围**：FI 全模块、CO 分配、MM 期间。
- **日期**：2023-11-20 | **负责人**：财务部 | **依据**：蓝图 BP-09-007/008。
### FI-07 利润中心/成本中心/科目结构
- **决策内容**：利润中心按渠道/大区设置（A100101-A100111 电商、A100201-A100207 线下、A200001 小红书），成本中心按部门（7-10 位），会计科目 10 位财政部统一编码，期初库存导入科目 9001900000。
- **决策原因**：渠道损益分析与部门费用归集需要。
- **影响范围**：FI/CO 全部、MM/SD 过账。
- **日期**：2023-11-17 | **负责人**：项目组 | **依据**：数据规则约定 §1.5-1.6、§2.1。
---
## 范围外决策（明确不用）
| 决策事项 | 决策内容 | 依据 |
|---------|---------|------|
| 生产执行 | 不使用厂内生产订单/离散制造，生产全部委外 | 蓝图 BP-05 |
| 银企直联 | 付款通过 SAP 付款申请 + 出纳手工付款，未启用银行直连 | 蓝图 BP-09-002 |
| 电商手工录单 | 电商销售订单不在 SAP 手工创建，走 OMS/中台自动生成 | 蓝图 BP-01 |
| 审批流（采购申请/订单） | 蓝图标注"现在无审批，需确认审批流"——**未决**，见 `未决问题清单.md` | 蓝图 BP-01 步骤 13/15 |
| 定制开发内部逻辑 | 不写入 KB，只记录接口触点 | 项目 KB 建设指引 §铁律 |
---
*蓝图决策记录.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 业务蓝图方案 V1.0 | 蓝图业务场景规划文档 V1.0 |
| 数据规则约定 V1.1 | 数据规则说明文档 V1.1 |
| 数据规则约定 | 数据规则说明文档 |
| 质检业务流程约定 | 质检业务流程文档 |
| 项目 KB 建设指引 | 一甸园建设指导书 |
| 接口开发负责人 | 李宝旭 |
KB_一甸园/集成约定.md 0 → 100644
View file @ 346d2f11
# 集成约定
> **文档类型**：项目 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）、中台方案设计
---
## 一、集成架构总览
```
电商平台（抖音/天猫/京东/拼多多/有赞/视频号/快团团/小红书/京东自营/天猫超市）
↓ 抓单 ↓ 订单/退货
OMS 中台 ◄──────────────────────────► 聚水潭 OMS（履约/云仓指令）
│ ↑ 接口（12条） │
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号当天及之后。
---
## 三、各集成点详情（触点）
### 3.1 采购入库（接口 1-1/1-2）
- **触发**：SAP 采购订单创建/审批后 → 自动同步到中台（状态"已审批"），且自动创建入库申请单；OMS 收货后 → 查询 OMS 收货数据 → SAP 创建采购入库单。
- **替代 SAP 手工步骤**：云仓采购收货过账（101）。
- **特殊约定**：
- 价格直接使用 SAP 的，不走中台价格目录逻辑。
- 采购订单已在中台时取消：中台和 SAP 分别手动取消。
- 中台校验数据是否已存在：不存在→创建单据并更新 SAP 状态；已存在→直接更新 SAP 状态。
- **异常升级**：OMS 收货异常、SAP 过账失败 → 查看中台日志定位单据，联系接口开发负责人。
- **开发文档**：`物料凭证接口设计记录` §5.1.6、`中台集成开发计划（2023-11）`。
- **Owner**：接口开发负责人/中台开发。
### 3.2 采购退货（接口 2-1/2-2）
- **触发**：SAP 建退货采购订单（勾退货）→ 同步 OMS 形成采购退货单 → OMS 发货 → 查询发货单 → SAP 创建采购退货单（移动类型 161）。
- **替代 SAP 手工步骤**：云仓采购退货出库过账。
- **异常升级**：退货单未同步、SAP 过账失败（缺参考物料凭证/移动原因）→ 检查 SAP 收货物料凭证与 ReferenceDocumentFiscalYear 参数。
- **开发文档**：`物料凭证接口设计记录` §5.1.7。
- **Owner**：接口开发负责人/中台开发。
### 3.3 B2B 销售出库（接口 3-1/3-2/3-3）
- **触发**：SAP 创建外向交货单 → 传输 OMS 形成销售订单（接聚水潭销售订单创建接口）→ OMS 发货 → 查询 OMS 销售出库单 → SAP 外向交货单过账；寄样单走 3-3。
- **替代 SAP 手工步骤**：B2B 发货过账（601）。
- **特殊约定**：销售订单额外字段有值时传字段值，无则传默认值。
- **异常升级**：发货过账失败 → 检查交货单是否已过账、OMS 出库状态；涉及财务注意实际发货日期。
- **开发文档**：中台方案设计 §B2B销售、`中台集成开发计划（2023-11）`。
- **Owner**：接口开发负责人/中台开发。
### 3.4 B2B 销售退货（接口 4-1/4-2）
- **触发**：SAP 创建销售退货订单 → 传输 OMS 形成售后单（接聚水潭其他入库创建接口）→ OMS 退货收货 → 查询售后收货数据 → SAP 创建退货交货单并过账。
- **替代 SAP 手工步骤**：B2B 退货入库过账。
- **异常升级**：退货收货数据回传出错（如部分退货单位不一致）→ 见 `操作特例_SD_销售.md` §4.1，需人工核对实际收货数量。
- **开发文档**：中台方案设计 §B2B销售退货。
- **Owner**：接口开发负责人/中台开发。
### 3.5 拆装功能（接口 7-1~7-4）
- **触发**：SAP 下达 0 价格委外单（ZY5）→ 采购订单传 OMS 生成入库单和出库单（其它入库/其它出库）→ OMS 通过云仓完成 → 基于 OMS 出库单 SAP 完成委外发料（541），基于 OMS 入库单 SAP 完成采购入库（101）+ 自动扣料（543）。
- **关键约定**：OMS **需要先做出库再做入库，且同时完成**。
- **替代 SAP 手工步骤**：拆装包发料/收货（541/101/543）。
- **异常升级**：云仓拆装未同步、SAP 过账失败 → 检查 OMS 出入库单状态与顺序。
- **开发文档**：`物料凭证接口设计记录` §5.1.8、接口测试记录 §拆装功能。
- **Owner**：接口开发负责人/中台开发。
### 3.6 移库出入库（接口 8-1~8-4）
- **触发**：SAP 下达库存转储单（UB）→ 发 OMS 其他出库单（工厂到云仓走采购入库单接口，云仓到云仓走其它出库/其它入库）→ OMS 云仓发货 → 查询出库状态 → SAP 创建库存转储单出库单（351），同时生成 OMS 其他入库单（出库有批次需指定批次入库）→ OMS 入库 → 查询入库状态 → SAP 完成转储入库（101）。
- **替代 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）
- **触发**：SAP 下达预留单 → 同步 OMS 创建其他入库/其他出库单 → OMS 完成 → 查询状态 → SAP 基于预留单创建成本中心入库（202）/出库（201）。
- **特殊约定**：移动类型 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 点同步一次当天数据。
- **Owner**：刘亚波（云仓物流箱出库）。
### 3.9 结算单（C端）+ 销售寄样单
- **触发**：接聚水潭销售出库单查询接口，中台同步结算系统后生成 SAP 销售订单/退货单（见 `操作特例_SD_销售.md`）。
- **同步频率**：结算单每天 4 点、16 点；寄样单每天 12 点、24 点。
- **Owner**：洪飞/中台。
### 3.10 物料主数据同步（产品主数据接口）
- **触发**：中台定时（1H）访问 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**：接口开发负责人/中台。
---
## 四、物料凭证创建接口（通用，触点说明）
**接口 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。
---
## 五、接口测试记录（来源：接口测试记录 V1.0）
| 场景 | SAP 单据 | OMS/聚水潭单据 | 结果 |
|------|---------|---------------|------|
| UB 工厂→云仓 | UB 4500000005（出库成品仓、入库天津仓）→ 4500000006 | 采购入库 927008（wms_co_id 13159759） | 入库 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）、生产/过期日期示例。
---
## 六、已知集成问题/待确认
| 问题 | 状态 | 详见 |
|------|------|------|
| 部分退货时 OMS 无法修改退货单位，导致回传 SAP 数据出错 | 待确认 | `操作特例_SD_销售.md` §4.1、`未决问题清单.md` |
| 调拨出库/入库跨月时数据传输后 SAP 需人工调整 | 待确认 | 中台方案设计 §调拨业务 |
| 接口未打通前 UB 调拨需 SAP+OMS 两边操作 | 已切换（4.8） | 本文件 §3.6 |
| B2B 退货"使用采购入/售后单"方式需与仓库确认 | 待确认 | 中台方案设计 §B2B销售退货 |
| 中台新物料上线后不管理分类，分类在 SAP 管理 | 已定 | 中台方案设计 §主数据管理 |
---
*集成约定.md | v1.0 | 2026-08-17*
---
## 附：源文档对照表（仅内部追溯用；对客户下发前请删除本表）
| 脱源描述（新） | 内部文档名（旧） |
|------|------|
| 接口确认记录 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 |
| 中台方案设计 | OMS 方案设计 |
| 接口开发负责人 | 李宝旭 |
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