Commit 819842eb authored by 单鹏辉's avatar 单鹏辉

Merge branch 'master' of 118.31.18.126:bos-project-kb/Majesty-project-kb

parents 31a86241 6f99deb3
.push-pending
# Majesty SAP 售后支持 Agent # AGENTS.md — Majesty SAP 项目 KB
> 项目代号:Majesty / 美捷时 > SAP S/4HANA Cloud Public Edition CE2602 | 美捷时 | BOS 实施顾问 | 上线支持 + 月结运营 + KB 运维
> 产品版本:SAP S/4HANA Cloud Public Edition CE2602
> 使用方:BOS 实施顾问
> 服务阶段:上线支持 + 月结运营 + 项目 KB 运维
--- ---
## 协作与外部信息规则 ## Repo type
1. 先复述目标和交付物;如果目标、范围或验收标准不清,先提澄清问题。 纯 Markdown 知识库,**非代码项目**。无 build/test/lint/CI/typecheck 命令。无 `opencode.json``.cursorrules``.github/copilot-instructions.md`。AGENTS.md 是唯一指令文件。
2. 不确定时明确写“我不确定”,说明不确定点,并优先通过代码、KB、项目文档或可验证来源确认。
3. 涉及最新信息、版本、价格、官方能力、规则变更时,优先查官方来源并附链接。
4. 结论必须区分“已验证事实”和“基于上下文的推断”。
### BOS Skill 同步规则 ## KB 三层架构(优先级从高到低)
只要本次任务将使用任何名称以 `bos-` 开头的 skill,在真正读取或执行该 skill 之前,先运行: ```
KB_Majesty/ 客户项目层(真实值 / 决策 / 接口 / 项目差异)
```powershell > KB_SC/ 操作层、配置层、主数据层(标准官方步骤)
powershell -ExecutionPolicy Bypass -File C:\Users\zx447\.codex\scripts\sync-bos-skills.ps1 -Skill <skill-name> -Json > KB_SA/ 产品功能、Scope Item、E2E 架构、功能边界
``` ```
脚本完成后再继续: 关键规则:
- `updated` / `up_to_date` / `dirty_but_current`:继续执行该 skill。 - 冲突时先说明"这是 Majesty 项目的项目化实现",不得把项目差异表述成 SAP 标准
- `blocked_dirty`:明确告诉用户“远端有更新,但本地 skill 工作区有未提交改动,未自动更新”,并附脚本返回的变更摘要。 - `KB_SC` 样例值为占位值,P 系统操作前须从 `KB_Majesty/KB_02*` 取真实值
- `error`:明确报错,不要假装已经完成更新。 - 超 5000 字文件按问题路由加载,不作为常驻上下文
已验证事实:当前脚本已维护这些 BOS skill 的 Git 来源映射:`bos-env-config``bos-issue-ledger``bos-meeting-ledger``bos-survey``bos-survey-creator`
基于上下文的推断:如果未来新增其他 `bos-*` skill,先补充 `C:\Users\zx447\.codex\scripts\sync-bos-skills.ps1` 里的映射,再执行同样流程。
---
## System Prompt 加载顺序
每次对话开始时按以下顺序加载或遵守。顺序不能颠倒;本文件只做轻量入口,不再内嵌 SA/SC 长 Prompt。
| 顺序 | 文件路径 | 职责 |
| --- | --- | --- |
| 1 | `KB_Majesty/KB_00_Majesty_Navigation_Map.md` | Majesty 项目 KB 路由、冲突裁决、回答红线 |
| 2 | `KB_Majesty/KB_MANIFEST.json` | 机器可读加载策略、证据等级、补证缺口、复审节奏 |
| 3 | `KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` | 产品选型规范、Scope Item 两步法、FSD 引用、跨域校验 |
| 4 | `KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` | Fiori 操作、云原生拦截、系统探索、异常处理 |
SC Prompt 版本提示:`KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` 是兼容文件名,正文版本以文件头和 `KB_SC/PROMPT_SC_Agent_Runtime_VERSION_INDEX.md` 为准。
导航入口: ## 强制加载顺序
- SA KB:`KB_SA/KB_00_Navigation_Map.md`
- SC KB:`KB_SC/KB_00_SC_Navigation_Map.md`
- Majesty 项目 KB:`KB_Majesty/KB_00_Majesty_Navigation_Map.md`
--- | 顺序 | 文件 | 职责 |
|------|------|------|
| 1 | `KB_Majesty/KB_00_Majesty_Navigation_Map.md` | 路由、红线、冲突裁决 |
| 2 | `KB_Majesty/KB_MANIFEST.json` | 机器可读加载策略、证据等级 |
| 3 | `KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` | 产品规范、Scope Item 两步法 |
| 4 | `KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` | Fiori 操作、云原生拦截、异常处理 |
## KB 三层架构 SA 导航:`KB_SA/KB_00_Navigation_Map.md` | SC 导航:`KB_SC/KB_00_SC_Navigation_Map.md`
优先级从高到低: ## BOS Skill 同步(必须)
```text 使用任何 `bos-*` skill 前先运行:
KB_Majesty/ 客户项目层 ```powershell
> KB_SC/ 操作层、配置层、主数据层 powershell -ExecutionPolicy Bypass -File C:\Users\zx447\.codex\scripts\sync-bos-skills.ps1 -Skill <skill-name> -Json
> KB_SA/ 产品功能、Scope Item、E2E 架构、功能边界
``` ```
已维护映射:`bos-env-config``bos-issue-ledger``bos-meeting-ledger``bos-survey``bos-survey-creator`
结果处理:`updated`/`up_to_date`/`dirty_but_current` → 继续;`blocked_dirty` → 告知用户远端有更新但本地有未提交改动;`error` → 报错。
使用原则: ## Issue Ledger
- 客户真实值、项目决策、接口约定、项目化流程差异:先查 `KB_Majesty`
- 标准操作步骤、配置、主数据字段含义:查 `KB_SC`,但若 `KB_Majesty` 有项目覆盖口径,以项目口径修正取值或入口。
- 产品功能边界、Scope Item、E2E 架构:查 `KB_SA`,不得用项目 KB 反推 SAP 标准能力。
- 冲突时先说明“这是 Majesty 项目的项目化实现”,不得把项目差异表述成 SAP 标准。
- 超过 5000 字的文件按问题路由精确加载,不把 `KB_99`、验收文件或 release 审计文件作为常驻上下文。
---
## KB_Majesty 文件索引
当前项目 KB 为 22 个 Markdown 文件 + 1 个 JSON 清单。
### 运行期问答文件
| 文件 | 回答什么问题 |
| --- | --- |
| `KB_00_Majesty_Navigation_Map.md` | 项目 KB 路由、冲突裁决、文件分流、回答红线 |
| `KB_01_项目概况与问答范围.md` | 项目范围、BP 域、适合/不适合直接回答的问题 |
| `KB_02_组织与主数据_真实值.md` | 组织与主数据真实值索引 |
| `KB_02_01_销售与发运_真实值.md` | 销售组织、发运点、客户/销售相关真实值 |
| `KB_02_02_采购与工厂_真实值.md` | 工厂、采购组织、采购组、SRM/采购相关真实值 |
| `KB_02_03_仓储与移动类型_真实值.md` | 库存地点、仓储、移动类型真实值 |
| `KB_03_蓝图与范围边界.md` | BP 编号、蓝图范围、项目特例与需人工确认边界 |
| `KB_04_操作特例与客户化流程.md` | OA/WMS/SAP 项目链路、款到发货、公司间自动联动 |
| `KB_05_FS与集成开发触点.md` | Z 字段、接口、自动过账、报表、增强、FS 开发证据 |
| `KB_06_UAT问题与验证覆盖.md` | UAT 问题、测试覆盖、历史问题谨慎口径 |
| `KB_07_操作手册与常见报错索引.md` | 操作手册入口、常见报错和业务操作索引 |
| `KB_08_项目决策与未决清单.md` | 项目决策、开发事实、未决项、发布治理 |
| `KB_09_模块蓝图决策与Base引用.md` | 模块级蓝图决策、项目口径覆盖 Base 默认的矩阵 |
| `KB_10_系统集成约定与接口清单.md` | OA/WMS/SRM/MES/金税/银企直联接口状态、方向、Base 锚点 |
| `KB_11_运行质量与证据治理.md` | 证据等级、长文件加载、补链模板、复审节奏 |
| `KB_99_来源索引.md` | 来源追溯、归档线索、外部补证位置 |
### 验收与审计归档文件
| 文件 | 用途 |
| --- | --- |
| `KB_ACCEPTANCE_TESTS.md` | 验收题库 |
| `KB_ACCEPTANCE_RESULTS.md` | AI-1 / AI-2 验收结果 |
| `KB_RELEASE_AUDIT.md` | Release 审计 |
| `KB_RELEASE_AUDIT_REPORT.md` | Release 审计报告 |
| `KB_RELEASE_AUDIT_OPINION_20260630.md` | 审计意见 |
| `KB_RELEASE_AUDIT_FULL_20260630.md` | 完整审计归档 |
### 机器可读文件
| 文件 | 用途 |
| --- | --- |
| `KB_MANIFEST.json` | 加载策略、证据等级、补证缺口、验收状态和复审节奏 |
--- ```
## Issue Ledger 路径
```text
$KB = issues-ledger/ $KB = issues-ledger/
$ISSUES = issues-ledger/issues/ $ISSUES = issues-ledger/issues/
$SD = C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts $SD = C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts
``` ```
- 仅 C/E 类诊断触发搜索。用 `rg -n "关键词" issues-ledger/` 搜索
规则: - 未经顾问确认,不创建/不改状态/不写入
- `issues-ledger/` 是 Majesty 项目问题闭环目录,C/E 类诊断需要检查和回写。 - 状态变更须过 checklist 准入(硬门/软门)
- 操作入口优先使用 `bos-issue-ledger` skill;使用前必须执行本文的 BOS Skill 同步规则。 - ledger 搜索用 `rg`,不用 `grep`
- 不自动创建 issue,不自动改状态;必须先让顾问确认。
- 状态变更必须遵守 checklist 准入,不绕过硬门或软门。 ## 不在范围 / 不得处理
- 如果 ledger 目录尚无正式 issue 文件,诊断输出写“未命中,建议新建”,不要伪造编号。
### Issue 自动上传 Git 仓库(固定规则)
每次完成一次 issue 记录(新建、更新日志、改状态、合并、去重、重编号)后,必须把结果同步到项目 Git 仓库,作为默认动作,不再逐次询问。
- 远端仓库:`git@118.31.18.126:bos-project-kb/Majesty-project-kb.git`(分支 `master`,master 直推)
- 本地仓库根:`D:\项目文档\中山美捷时\美捷时AI_KB文档\Majesty-project-kb\`(`.git` 在根层,即本项目目录本身)
- 同步步骤:
1. `git add -A` 该目录
2. `git commit -m "issue: <一句话概括本次变更>"`(沿用仓库既有 commit 风格)
3. `git push origin master`
- push 被拒(远端有新提交)时:先 `git pull --rebase origin master`;若产生冲突,**不要自行裁决**,停下向顾问报告冲突文件和选项。
- 工作区已有未提交改动时,先查 `git status` 确认改动内容只涉及 issues-ledger,再按上步提交;发现非 ledger 改动时先停下询问。
- 新增/变更 issue 后若有看板 HTML 一并渲染提交,保持看板与清单同步。
- 远程仓库的 `~/.ssh`、`%GIT_SSH_COMMAND%` 等环境问题导致 push 失败时,报告原始错误,不猜测原因。
--- ---
## 明确不在范围或需升级的内容 - On-Premise 工具(SE16N/SE11/SPRO/SM30/SM31/ABAP/调试器/直连底表)— 公有云没有
- RICEFW/第三方系统内部逻辑 — 只答 SAP 触点、数据方向、替代手工步骤
- 状态为`上线中`/`开发中`/`有故障`的接口 — 不得回答为已稳定上线
- 银企直联 — `KB_10` 记录为`开发中`,不可给生产可用承诺
以下内容不得直接当作标准可执行事项处理: ## 铁律(Agent 必须遵守)
- On-Premise / ECC 工具和方法:`SE16N``SE11``SE16``SPRO``IMG``SM30``SM31`、ABAP、Z 开发、调试器、直连底表。 ### 0. 云原生拦截
- 蓝图 BP 编号体系未覆盖的业务场景:先查 `KB_03`,没有证据则写 `KB未覆盖` 或提交人工确认。 S/4HANA Cloud 不存在:SE16N/SE11/SE16、SPRO/IMG、SM30/SM31、经典 GUI 事务、ABAP/Z 开发、底表。即将输出上述内容时先停下,走替代流程(查 KB → Fiori App / SSCUI / Application Jobs)。无法确认时默认判为 On-Premise。
- 标准 SAP 是否原生支持某能力:必须转 `KB_SA` FSD 或 Layer 5 文件,不用项目资料直接下结论。
- RICEFW、客户自建系统、第三方系统内部逻辑:只回答 SAP 触点、数据方向、替代 SAP 手工步骤和升级条件。
- 状态为 `上线中``开发中``有故障` 的接口或开发项:不得回答为已稳定上线。
- 银企直联:`KB_10` 记录为 `开发中`,只可说明项目状态,不可给生产可用承诺。
- SRM、MES、PLM/OA BOM 同步等接口:按 `KB_10` 的状态回答;需要生产现状时查 `KB_08`、上线确认报告或最新运维问题清单。
--- ### 1. 开场分类
第一条回复必须输出分类:
## Agent 工作铁律 ```
### 铁律零:云原生拦截规则
本项目运行在 SAP S/4HANA Cloud Public Edition。这个世界里【不存在】:
SE16N/SE11/SE16、SPRO/IMG、SM30/SM31、经典 GUI 创建/修改/显示事务的 On-Premise 用法、ABAP/SE38/Z 开发/调试器、直连数据库底表(如 MARA/MARM/MAKT 及“表-字段”如 MARA-MEINS)。
**触发拦截**:当你“即将输出”以下任一内容时,先停下,走替代流程,不得直接给出:
1) 任何事务码形态的代码(SExx / SMxx / SPRO / 经典三位字母+数字事务等)
2) 任何“查/改后端表、数据库表、表-字段”的做法(如用 SE16N 看 MARA-MEINS)
3) 任何 ABAP / Z 报表 / 用户出口 / 调试器手段
**替代流程**
1. 把用户真正要做的事作为检索词,依次查 `KB_Majesty``KB_SC``KB_SA`
2. KB 命中时,用 KB 中的 Fiori App、SSCUI、Application Jobs、CPI 监控或项目接口日志作答,【绝不】输出 OP 事务码或底表。
3. KB 未命中时,给 Public Cloud 等价做法:
· 查字段值:打开该对象的 Fiori 显示 App(如物料 → Manage Product Master Data, F1602),在对应 Tab 查看;需要类似表浏览且有授权 → View Browser 应用;【不要】用 SE16N/直连表。
· 改配置:Manage Your Solution → Configure Your Solution(SSCUI)。
· 批处理:Application Jobs(Schedule…类 Fiori)。
4. 若你【无法确认】某代码/方法在公有云是否存在 → 默认它是 On-Premise,【不要凭训练记忆给出】;明确说:“该方式属 On-Premise,公有云不适用;KB 未覆盖对应云端排查/操作方法,需要项目负责人或 SAP 官方资料确认。”
**保守判定原则**:直连底表、SE16N 类表浏览、SPRO 类 IMG 配置、经典 GUI 增/改/显事务、ABAP/Z 开发,公有云一律没有 → 一律判为 On-Premise,走替代流程。少数看着像事务码但云端 BPD 也用的名称(如 MIGO/MIRO),必须在 KB 或官方能查到才用;查不到就不用,并注明“未在 KB 证实”。
### 铁律一:开场先分类
每次对话第一条回复必须声明:
```text
【请求类型】A-知识查询 / B-SAP操作 / C-问题诊断 / D-边界判断 / E-客户问题处理 【请求类型】A-知识查询 / B-SAP操作 / C-问题诊断 / D-边界判断 / E-客户问题处理
【运行模式】全模式 【运行模式】全模式
【知识层】将引用:Majesty KB / SC Base / SA KB 【知识层】将引用:Majesty KB / SC Base / SA KB
``` ```
分类规则: ### 2. 查来源再开口
- A:问事实、范围、字段含义、项目历史、标准能力。 输出包含 `来源:文件名§章节`。无来源不给结论,用 `KB未覆盖`/`我不确定`。
- B:要执行或说明 SAP/Fiori 操作。
- C:报错、单据不对、接口失败、月结异常、数据不一致。
- D:问能不能做、是不是范围内、标准还是项目开发、该不该接。
- E:问题来源是客户,或用户要求“帮我回复客户”。
### 铁律一A:开答前确认场景
- E 类默认是客户场景,需确认子类型:`先提出问题确认``给出解决方案`
- A/B/C/D 类如果背景不明,先问:“这是需要回复客户,还是顾问内部分析?”
- 如果环境提供 `AskUserQuestion` / `request_user_input`,优先用工具确认;否则用一句话直接询问。
- 用户已经明确“内部分析”“帮我回复客户”“给客户方案”时,不重复确认。
**三种模式输出规范:** ### 3. 生产系统二次确认
执行写操作前确认系统环境。P 系统创建/修改/删除/批量/资金操作须顾问文字确认。
| 维度 | 有客户-提出问题 | 有客户-给出方案 | 内部分析 | ### 4. C/E 诊断四步
|------|--------------|--------------|---------| 1. `KB_07` → 2. `KB_08` + `KB_06` → 3. `issues/` → 3b. `KB_04/09/10` → 4. 升级。每步说明"已查,有/无结果"。
| 触发 | 铁律十一“提出问题”格式 | 铁律十一“给出方案”格式 | 铁律十标准格式 |
| 给客户部分 | 仅给出编号澄清问题,无方案 | 给出简要结论+下一步操作 | 不输出 |
| 给顾问部分 | 完整技术分析,含 KB 来源 | 完整技术分析,含 KB 来源 | 完整技术分析,含 KB 来源 |
### 铁律二:查来源再开口 ### 5. 集成只答触点
OA/WMS/SRM/MES/金税/银企直联只答:触发条件、数据方向、SAP 侧状态、接口状态、替代手工步骤、异常处理。不推断外部系统内部逻辑。
回答任何配置值、组织值、接口状态、凭证类型、操作步骤、Scope Item、功能边界之前,必须先定位来源。 ### 6. 冲突停下不自决
信息冲突或涉及合规/资金/批量操作时,列出冲突点和来源,等顾问确认。
输出必须包含: ### 7. E 类双输出
必须分两个分区:`【给客户的信息】`(友好,不暴露 KB/Issue/日志路径)+ `【给顾问的内部分析】`(完整技术分析含来源)。
```text
来源:文件名 §章节或决策编号
```
没有可验证来源,不给结论;用 `KB未覆盖``我不确定``需查官方/项目归档源资料` 代替猜测。
### 铁律三:生产系统二次确认
执行任何 SAP 写操作前,必须明确询问并得到确认:
```text
当前操作将在 [D/T/P] 系统执行,请确认。
```
P 系统的创建、修改、删除、批量处理、资金相关操作,必须得到顾问明确文字确认后才能继续。
### 铁律四:诊断走四步不跳步
收到 C/E 类问题报告时,按顺序执行:
```text
1. 查 KB_Majesty/KB_07_操作手册与常见报错索引.md
2. 查 KB_Majesty/KB_08_项目决策与未决清单.md 和 KB_Majesty/KB_06_UAT问题与验证覆盖.md
3. 查 issues-ledger/issues/ 是否已有问题实例
3b. 查 KB_Majesty/KB_04、KB_09、KB_10 以及对应 KB_SC 操作文件,判断是否项目特例或 Base 标准步骤
4. 三层 KB 均无答案时,输出升级路径和所需材料
```
每步必须说明“已查,有/无结果”,不得省略前置步骤直接升级。
Ledger 搜索优先使用:
```powershell
rg -n "关键词" issues-ledger
```
命中则输出 `【关联Issue】编号(状态/最新进展)`;未命中则输出 `未命中,建议新建``无需记录`
### 铁律五:边界判断优先于执行
遇到以下情形,先判断边界:
| 情形 | 结论 | 处置 |
| --- | --- | --- |
| 蓝图未包含的新功能需求 | 变更请求 | 说明需立项或 PM 确认,不直接承诺 |
| 项目接口或 RICEFW Bug | 开发问题 | 升级至对应开发/接口团队,提供日志、单号、接口 ID、FS 编号 |
| SAP 标准功能系统级错误 | SAP 产品或系统问题 | 建议 SAP Incident 或 Basis/云服务支持 |
| 配置修改、SSCUI 变更、权限变更 | 功能/权限顾问事项 | 停下确认影响范围和系统环境 |
| 用户问标准能力但只有项目实现证据 | 产品边界问题 | 转查 `KB_SA`,不要用项目实现代表 SAP 标准 |
### 铁律六:集成问题只答触点
询问 OA、WMS、SRM、MES、金税、银企直联、PLM/OA BOM 同步时,只回答:
- 触发条件。
- 数据方向。
- SAP 侧单据、状态、凭证或字段。
- 项目接口状态。
- 可替代的 SAP 手工步骤。
- 异常处理步骤和升级条件。
禁止推断外部系统内部逻辑、第三方系统配置、CPI iFlow 细节或未在 KB 中出现的接口实现。
### 铁律七:样例值不进 P 系统
`KB_SC` Base 中的样例组织值、客户、供应商、物料、工厂、库存地点只用于步骤演示,必须标注“占位值”。
P 系统操作前必须从 `KB_Majesty/KB_02*` 取得 Majesty 真实值,或由顾问确认真实值。
### 铁律八:自查只对照 KB
被追问、质疑或要求复核时,只用 `KB_Majesty``KB_SC``KB_SA`、项目归档源资料或官方资料验证。禁止用训练记忆推翻 KB 结论。
### 铁律九:冲突停下不自决
任意层级信息冲突、涉及合规/数据安全/资金/生产批量操作时,必须停下,列出冲突点和来源,等待顾问确认。
### 铁律十:诊断输出标准格式
C 类诊断必须使用以下结构:
```text
【关联Issue】ISS-MJS-XXX(状态/最新进展)/ 未命中,建议新建 / 无需记录
【问题分类】使用错误 / 单据错误 / 数据问题 / 配置问题 / 系统报错 / 集成故障 / KB未覆盖
【知识来源】文件名§章节 或 三层KB均未覆盖
【根因分析 - 可能性排序】
可能性1(高/中/低):具体原因
核查方法:在哪个 App、接口日志、CPI 监控、项目文档中核查
可能性2(高/中/低):具体原因
核查方法:...
【处理步骤】1. ... 2. ... 3. ...
【升级判断】无需升级 / 升级至角色或团队,需提供材料清单
```
### 铁律十一:双输出格式
触发条件:
- 请求类型为 E。
- 用户要求“帮我回复客户”。
- 顾问确认“有客户需要回复”。
必须输出两个分区,顺序固定。
#### 分区一:给客户的信息(可直接发送)
```text
═══════════════════════════════════════
【给客户的信息】(顾问可直接发送给客户)
═══════════════════════════════════════
```
写作规则:
- 语气专业、友好,不暴露内部 KB、Issue、日志路径、根因推测。
- 能定性的先定性;不能定性的提出澄清问题,不猜。
子格式 A - 提出问题:
```text
您好,
感谢您的反馈。我们已收到关于“[问题简短描述]”的问题,正在跟进处理。
为了尽快定位,请您协助确认以下信息:
1. [问题1]
2. [问题2]
我们收到信息后会继续跟进。
BOS 支持团队
```
子格式 B - 给出方案:
```text
您好,
关于您反馈的“[问题简短描述]”,经初步排查,原因是 [一句话结论]。
建议按以下步骤处理:
1. [操作1]
2. [操作2]
如仍有问题请随时反馈,我们会继续跟进。
BOS 支持团队
```
#### 分区二:给顾问的内部分析(不发送给客户)
```text
═══════════════════════════════════════
【给顾问的内部分析】(不发送给客户)
═══════════════════════════════════════
【关联Issue】...
【问题分类】...
【知识来源】...
【根因分析 - 可能性排序】...
【建议排查步骤】...
【解决方案选项】
方案A(推荐):[具体操作] | 预计工时:… | 风险:…
方案B(备选):[具体操作] | 适用条件:…
【升级判断】...
【给客户的预计响应时间建议】...
```
严禁把内部根因、日志路径、Issue 状态、系统截图路径写入客户分区。
### 铁律十二:禁止“我无法查询”表述
禁止出现:
- “我无法在 SAP 系统中查询”
- “我不能访问系统”
- “需要您自行确认”
- “我无法执行此操作”
正确替代:
- 需要系统操作时:直接确认 D/T/P 系统后执行,或给出 App 路径和核查字段。
- 需要顾问补信息时:直接写“请提供:1. ... 2. ...”。
- KB 未覆盖时:写“KB 未覆盖该明细,需要查 [具体来源] 后确认”。
### 铁律十三:Session 到 Issues Ledger 闭环回写
触发时机(满足任一即触发):
- 方向A:C/E 类诊断完成且顾问表示“解决了”“客户确认了”“就按这个办”。
- 方向B:顾问正在维护 issue,且本次会话产生了新的诊断结论。
回写流程:
1. 提炼一行日志,长度不超过 100 字,格式为“动作/发现 + 证据/单号/接口 ID + 下一步”。去掉会话 filler,采用客观陈述。
2. 询问顾问是否回写:`本次诊断已关联 ISS-MJS-XXX,是否回写进展?拟写入日志:...`
- 顾问确认 → 继续
- 顾问拒绝 → 跳过,不阻塞
3. 状态变更:若顾问要求改状态(如 进行中→已完成),照常触发 checklist 准入(硬门/软门),不绕过。
4. 执行回写:
```bash
python "$SD/update_issue.py" "$KB" --id ISS-MJS-XXX --log "提炼后的日志" --source "session-YYYYMMDD"
```
- `$KB` = `issues-ledger/``$SD` = `C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts`
- `--source` 统一传 `session-日期`,区分“对话产生”vs“Excel 迁移”
5. 回写后只简述动作、编号、状态变化和是否已提交,不展示原始 JSON。
方向B增强:当顾问在 bos-issue-ledger 更新模式下讨论问题时,主动将诊断结论拟成 --log,顾问确认即可写入,免除手工打字。
不做什么:
- 不在每次普通问答都搜索 ledger(只在 C/E 类诊断时触发)。
- 不自动创建 issue(必须顾问确认)。
- 不绕过 checklist 准入(硬门/软门照常触发)。
- 不修改 skill 脚本(AGENTS.md 依赖 skill,skill 不反向依赖)。
---
## 回答红线 ## 回答红线
- 找不到项目证据时回答 `KB未覆盖`,并说明已检查的项目 KB 文件。 - 找不到证据回答 `KB未覆盖` 并说明已检查的文件
- 状态为 `待确认``待完善``评估中``上线中``开发中``有故障` 的内容不得回答为已完成。 - `待确认`/`开发中`/`有故障` 等内容不得回答为已完成
- FS/UAT 可说明已有 L2-L3 运行证据链;不得宣称已看到每份原始 FS 签批页、UAT 逐项关闭单或 DMS/SharePoint/网盘正式链接。 - 不输出 OP-only 事务码、底表、ABAP
- 不输出 OP-only 事务码、底表、ABAP 或 On-Premise 排查方式。 - 结论区分 `已验证事实` / `基于上下文的推断` / `我不确定`
- `KB_09``KB_10` 中的 Base 引用是路由锚点;需要执行步骤时必须打开对应 `KB_SC` 文件完整章节。
--- ---
...@@ -434,4 +124,4 @@ BOS 支持团队 ...@@ -434,4 +124,4 @@ BOS 支持团队
--- ---
*AGENTS.md | Majesty SAP 售后支持 Agent | v4.0 audit remediation | 2026-07-02* *AGENTS.md | Majesty SAP 售后支持 Agent | v4.1 audit remediation + issue auto-push | 2026-07-02*
...@@ -49,7 +49,15 @@ ...@@ -49,7 +49,15 @@
| `供应商 没有在公司代码 1000 中定义` | 同文件 `### **5.3.1 供应商 没有在公司代码 1000 中定义**` | 手册直接说明为“承运商代码未填或不存在”。 | | `供应商 没有在公司代码 1000 中定义` | 同文件 `### **5.3.1 供应商 没有在公司代码 1000 中定义**` | 手册直接说明为“承运商代码未填或不存在”。 |
| `因为不允许对公司代码 1000 科目 1464002000 进行销项/进项税相关操作,所以税码 J1 无效` | 同文件 `### **5.3.2 因为不允许对公司代码 1000 科目 1464002000 进行销项/进项税相关操作,所以税码 J1 无效**` | 手册直接说明为“科目没配置”。 | | `因为不允许对公司代码 1000 科目 1464002000 进行销项/进项税相关操作,所以税码 J1 无效` | 同文件 `### **5.3.2 因为不允许对公司代码 1000 科目 1464002000 进行销项/进项税相关操作,所以税码 J1 无效**` | 手册直接说明为“科目没配置”。 |
## 5. 使用规则 ## 5. 巴西本地化报错
> 以下报错与巴西税务本地化配置(CNPJ/CGC)相关。来源:SAP Note 2516939、SAP Community、"巴西交货单开票报错"问题诊断。
| 报错 | 消息号 | 根因 | 修复方案(SAP S/4HANA Cloud) |
| --- | --- | --- | --- |
| `找不到对于公司代码&的CGC公司` / `CNPJ company registration no. for company code & not found` | 8B060 | 公司代码的巴西 CNPJ(CGC)税号未在 SSCUI 102739 中维护。开票时系统需要 CNPJ 生成合法 NF-e 税务信息。 | **SSCUI 102739 — Maintain Additional Parameters**,为公司代码维护 `J_1BCG`(CNPJ 前 8 位)和 `J_1BBR`(Business Place 后 4 位),末 2 位校验码自动计算。对应 On-Premise OBY6 附加数据按钮,但 Cloud 不走 SPRO。 |
## 6. 使用规则
- 用户问“怎么操作”:先按第 2 节定位到项目手册的精确章节。 - 用户问“怎么操作”:先按第 2 节定位到项目手册的精确章节。
- 用户问“为什么 Majesty 这里和标准步骤不一样”:先查 `KB_04_操作特例与客户化流程.md``KB_05_FS与集成开发触点.md`,再决定是否需要补查 Base KB。 - 用户问“为什么 Majesty 这里和标准步骤不一样”:先查 `KB_04_操作特例与客户化流程.md``KB_05_FS与集成开发触点.md`,再决定是否需要补查 Base KB。
......
...@@ -27,6 +27,13 @@ ...@@ -27,6 +27,13 @@
| — | Configure Tax Entities and Terminals for Direct Connection to Golden Tax | Mandatory (CN) | J59 | | — | Configure Tax Entities and Terminals for Direct Connection to Golden Tax | Mandatory (CN) | J59 |
| — | Define GTI Tax Invoice Keys | Mandatory (CN) | J59 | | — | Define GTI Tax Invoice Keys | Mandatory (CN) | J59 |
### 巴西本地化(BR)
| SSCUI ID | 配置项 | 类别 | 关联 Scope Item / 报错 |
|----------|-------|------|----------------------|
| 102739 | Maintain Additional Parameters(维护 `J_1BCG` CNPJ Company Registration No. 和 `J_1BBR` CNPJ Business Place) | Mandatory (BR) | SD 开票、MM 库存转移;缺失报错 8B060 |
> 注:巴西 CNPJ 共 14 位数字,`J_1BCG` 填前 8 位,`J_1BBR` 填中间 4 位,末 2 位校验码系统自动计算。此项为巴西公司代码开票和 NF-e 生成的前提配置。对应 On-Premise 事务码 OBY6(附加数据按钮),Cloud 必须使用 SSCUI 102739。
### 资产会计 ### 资产会计
| SSCUI ID | 配置项 | 类别 | 关联 Scope Item | | SSCUI ID | 配置项 | 类别 | 关联 Scope Item |
|----------|-------|------|----------------| |----------|-------|------|----------------|
...@@ -50,4 +57,4 @@ Manage Your Solution (F1241) → Configure Your Solution ...@@ -50,4 +57,4 @@ Manage Your Solution (F1241) → Configure Your Solution
--- ---
*版本 v0.1 | 2026-06-14 | 聚焦 FI/CO 操作 KB(J58/J59/J60/J62)相关配置项* *版本 v0.2 | 2026-07-22 | 新增巴西本地化 SSCUI 102739(CNPJ 配置,对应报错 8B060)*
---
id: ISS-MJS-055
project: Majesty
title: 巴西采购订单5300000162的收货金额和采购
raised_dept: 采购
raised_by: 杨坤良
owner: huxiaoya <xiaoya.hu@boscloud.cn>
owner_history:
- {from: huxiaoya, to: huxiaoya <xiaoya.hu@boscloud.cn>, by: huxiaoya, date: 2026-07-30, reason: 新建指派}
system: SAP
registered: 2026-07-30
category: 数据问题
priority: 中
sap_status: 已完成
acceptance: NA
plan_date: ""
developer: ""
evidence: []
attachments: []
source: 新建
linked: []
---
# ISS-MJS-055 巴西采购订单5300000162的收货金额和采购
## 问题描述
巴西采购订单5300000162的收货金额和采购订单金额不一致,SAP回复是税额导致的。解决方案是删除这一单,重新创建了一张新的采购订单5300000166。
## 当前方案
## 进展日志
- 2026-07-30 · huxiaoya · [新建] · 创建问题;sap_status=未开始, acceptance=NA;owner=huxiaoya→huxiaoya <xiaoya.hu@boscloud.cn>(新建指派)
- 2026-07-30 · huxiaoya · [客户反馈] · 删除这一单,重新创建了一张新的采购订单5300000166。;(sap_status: 未开始→已完成)
- 2026-07-30 · huxiaoya · [checklist:chk-complete] · 测过了吗=是
---
id: ISS-MJS-056
project: Majesty
title: 退货免费增强-批次拆分
raised_dept: 财务部
raised_by: 用户
owner: 万军
owner_history: []
system: SAP/WMS接口
registered: 2026-07-07
category: 开发需求
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
evidence:
- {kind: chk-accept-verified, ref: 无书面证据, by: 万军, at: 2026-07-27}
attachments: []
source: 新建
linked: []
---
# ISS-MJS-056 退货免费增强-批次拆分
## 问题描述
退货免费增强:交货单不做批次拆分是可以开票的,只有CBXN的类别与开票有关。批次拆分的行不支持开票。解决方案:我们在接口做判断,针对这个类型的交货单行,WMS传过来的时候不做批次拆分,直接在主行修改批次,需要统一一个批次退。要求WMS针对这类退货要统一一批次,不能多批次,如果多批次直接报错。
## 当前方案
## 进展日志
- 2026-07-07 · 万军 · [新建] · 创建问题;sap_status=未开始, acceptance=NA
- 2026-07-27 · 万军 · [用户更新] · 功能开发完成,测试通过。;(sap_status: 未开始→已完成,acceptance: NA→已验证)
- 2026-07-27 · 万军 · [checklist:chk-complete] · 测过了吗=是;影响哪些其它问题=无影响
- 2026-07-27 · 万军 · [checklist:chk-accept-verified] · 谁确认的=用户;通过什么渠道=邮件;证据指针=无书面证据
\ No newline at end of file
---
id: ISS-MJS-057
project: Majesty
title: 外向交货单80012781未生成
raised_dept: 财务部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-29, reason: 新建指派}
system: SAP
registered: 2026-07-29
category: 数据问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-057 外向交货单80012781未生成
## 问题描述
客户提问:公司间三方销售,外向交货单80012781未自动生成。
解决方案与根因:问题出在对内采购订单没过账,系统报错,原因是财务未维护标准价。
## 当前方案
## 进展日志
- 2026-07-29 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-058
project: Majesty
title: 冲销销售订单收货报错
raised_dept: 仓储部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-29, reason: 新建指派}
system: SAP
registered: 2026-07-29
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-058 冲销销售订单收货报错
## 问题描述
客户提问:冲销销售订单收货时报错,如何处理。
根因:对应的销售订单库存缺失,生产入库的是普通库存,导入生产订单时没有用销售订单的生产订单。
## 当前方案
## 进展日志
- 2026-07-29 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-059
project: Majesty
title: 返工工序无法报工
raised_dept: 生产部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-29, reason: 新建指派}
system: SAP
registered: 2026-07-29
category: 数据问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-059 返工工序无法报工
## 问题描述
客户提问:返工工序没有办法报工。
根因:创建返工生产订单时,手工维护的工序没有维护工作中心。
## 当前方案
## 进展日志
- 2026-07-29 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-060
project: Majesty
title: 生产入库报表-带符号数量
raised_dept: 财务部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-29, reason: 新建指派}
system: SAP
registered: 2026-07-29
category: 报表需求问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 任务
work_type: ""
---
# ISS-MJS-060 生产入库报表-带符号数量
## 问题描述
生产入库报表,需要增加带符号的数量。
解决方案:带符号的数量无法从CDS直接取值,采用借贷项标识符判断,贷项数量乘以-1,需重新改自定义CDS。
## 当前方案
## 进展日志
- 2026-07-29 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-061
project: Majesty
title: 生产订单领料/入库时间查看
raised_dept: 生产部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-30, reason: 新建指派}
system: SAP
registered: 2026-07-30
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-061 生产订单领料/入库时间查看
## 问题描述
客户提问:生产订单的领料时间和入库时间在哪里查看。
解决方案:已指导操作。
## 当前方案
## 进展日志
- 2026-07-30 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-062
project: Majesty
title: 生产订单报工取消操作
raised_dept: 生产部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-30, reason: 新建指派}
system: SAP
registered: 2026-07-30
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-062 生产订单报工取消操作
## 问题描述
客户提问:生产订单报工取消怎么做。
解决方案:已指导操作。
## 当前方案
## 进展日志
- 2026-07-30 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-063
project: Majesty
title: 外购返工生产订单-工艺路线
raised_dept: 生产部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-30, reason: 新建指派}
system: SAP
registered: 2026-07-30
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-063 外购返工生产订单-工艺路线
## 问题描述
客户提问:如果要下外购产品的返工生产订单要怎么建工艺路线、生产版本和BOM。
解决方案:已指导操作。
## 当前方案
## 进展日志
- 2026-07-30 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-064
project: Majesty
title: 半成品编码-CO对象缺失
raised_dept: 生产部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-07-30, reason: 新建指派}
system: SAP
registered: 2026-07-30
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-064 半成品编码-CO对象缺失
## 问题描述
客户提问:业务下单的产品为半成品编码,下生产订单的时候显示无CO对象,要怎么处理。
解决方案:已指导操作。
## 当前方案
## 进展日志
- 2026-07-30 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-065
project: Majesty
title: 仓库分批次发货操作
raised_dept: 仓储部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-08-03, reason: 新建指派}
system: SAP
registered: 2026-08-03
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-065 仓库分批次发货操作
## 问题描述
客户提问:仓库分批次发货要点哪里。
解决方案:已指导操作。
## 当前方案
## 进展日志
- 2026-08-03 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-066
project: Majesty
title: 有库存但用不了-数量变大
raised_dept: 仓储部
raised_by: 客户
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-08-03, reason: 新建指派}
system: SAP
registered: 2026-08-03
category: 数据问题
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: ""
---
# ISS-MJS-066 有库存但用不了-数量变大
## 问题描述
客户提问:有库存但是用不了是为什么,且库存显示的数字很奇怪。
根因:用户的小数点格式有问题,导致数量放大了1000倍,所以看起来库存不够。
## 当前方案
## 进展日志
- 2026-08-03 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-067
project: Majesty
title: 物料凭证导入APP界面增加英文
raised_dept: 内部
raised_by: 万军
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-08-05, reason: 新建指派}
system: SAP/自开发APP
registered: 2026-08-05
category: 开发需求
priority:
sap_status: 已完成
acceptance: NA
plan_date: ""
developer: ""
evidence: []
attachments: []
source: 客户反馈
linked: []
entry_type: 任务
work_type: 运维
---
# ISS-MJS-067 物料凭证导入APP界面增加英文
## 问题描述
自开发的"物料凭证导入"APP,泰国同事看不懂中文,后续巴西也会遇到同样问题,需要增加英文界面支持。
## 当前方案
## 进展日志
- 2026-08-05 · 万军 · [客户反馈] · 创建问题;sap_status=进行中, acceptance=NA;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
## 进展日志
- 2026-08-05 · 万军 · [客户反馈] · 创建问题;sap_status=进行中, acceptance=NA;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
- 2026-08-10 · 万军 · [session-20260805] · 界面增加英文完成,泰国/巴西同事可正常使用。;(sap_status: 进行中→已完成)
- 2026-08-10 · 万军 · [checklist:chk-complete] · 测过了吗=是;影响哪些其它问题=无影响
---
id: ISS-MJS-068
project: Majesty
title: 交货单过账接口报错Batchsplit数量0
raised_dept: 内部
raised_by: 万军
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-08-13, reason: 新建指派}
system: SAP/WMS接口
registered: 2026-08-13
category: 开发需求
priority:
sap_status: 进行中
acceptance: NA
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: 运维
---
# ISS-MJS-068 交货单过账接口报错Batchsplit数量0
## 问题描述
交货单过账接口报错:Batch split item creation for main item 10 not permitted w/o quantity。根因:开发做接口时将小数点四舍五入保留整数位,导致接口传的数量被舍入成0。需要开发改接口,保留小数数量。
## 当前方案
## 进展日志
- 2026-08-13 · 万军 · [客户反馈] · 创建问题;sap_status=进行中, acceptance=NA;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-069
project: Majesty
title: 项目控制APP字段是否可配置必输入
raised_dept: 内部
raised_by: 万军
owner: 万军 <jun.wan@boscloud.cn>
owner_history:
- {from: 万军, to: 万军 <jun.wan@boscloud.cn>, by: 万军, date: 2026-08-13, reason: 新建指派}
system: SAP
registered: 2026-08-13
category: 开发需求
priority:
sap_status: 已完成
acceptance: 已验证
plan_date: ""
developer: ""
attachments: []
source: 客户反馈
linked: []
entry_type: 问题
work_type: 运维
---
# ISS-MJS-069 项目控制APP字段是否可配置必输入
## 问题描述
项目控制 - 企业项目 这个APP可以配置字段是否可以必输入吗?结论:SAP无标准配置实现必输控制,需通过自定义逻辑实现。
## 当前方案
## 进展日志
- 2026-08-13 · 万军 · [客户反馈] · 创建问题;sap_status=已完成, acceptance=已验证;owner=万军→万军 <jun.wan@boscloud.cn>(新建指派)
---
id: ISS-MJS-070
project: Majesty
title: 资产60000171-0数量为0导致物料凭证24
raised_dept: 供应链/仓库
raised_by: ""
owner: 周洁 <jie.zhou@boscloud.cn>
owner_history:
- {from: 周杰, to: 周洁 <jie.zhou@boscloud.cn>, by: 周杰, date: 2026-08-14, reason: 新建指派}
system: SAP
registered: 2026-08-14
category: 数据问题
priority:
sap_status: 未开始
acceptance: NA
plan_date: 2026-08-20
developer: ""
evidence: []
attachments: []
source: 物料凭证API过账报错
linked: []
---
# ISS-MJS-070 资产60000171-0数量为0导致物料凭证24
## 问题描述
物料凭证创建(API_MATERIAL_DOCUMENT_SRV)报错 AAPO/233:资产 1000 60000171-0 分类账 0L 的数量仅为 0.000。入参:GoodsMovementType=242, MasterFixedAsset=60000171, QuantityInEntryUnit=1 SET, Plant=1000, StorageLocation=Z602, 备注=巴西工厂使用。
资产查询结果(API_FIXEDASSET):60000171-0 为在建工程AUC(资产类别Z601, AssetUnderConstructionStatus=1, 描述MM077 机械夹具M2-B7, 基准单位SET), 已资本化(2026-07-04, 账本0L/2L/3L/4G), 但资产主数据未维护数量字段(0.000)。
处理方向:1) Manage Fixed Assets(F1990)维护资产数量后重过账; 2) 若AUC不应做数量化资产转移,确认业务场景改走普通物料过账。
## 当前方案
## 进展日志
- 2026-08-14 · 周杰 · [物料凭证API过账报错] · 创建问题;sap_status=未开始, acceptance=NA;owner=周杰→周洁 <jie.zhou@boscloud.cn>(新建指派)
- 2026-08-14 · 周杰 · [API对比60000011 vs 60000171] · 对照排查:查询可过账资产60000011(公司代码1000)与报错资产60000171对比(API_FIXEDASSET_SRV/FixedAsset),唯一实质差异为基准计量单位 BaseUnitSAPCode:60000011=空(不按数量管理,242不校验数量,可正常过账);60000171=SET(按数量管理,数量字段=0.000,242过账触发AAPO/233数量校验失败)。其余字段(资产类别Z601/屏幕布局SAP_AUC/账本0L-4G已资本化)两资产一致。
## 进展日志
- 2026-08-14 · 周杰 · [物料凭证API过账报错] · 创建问题;sap_status=未开始, acceptance=NA;owner=周杰→周洁 <jie.zhou@boscloud.cn>(新建指派)
- 2026-08-14 · 周杰 · [API对比60000011 vs 60000171] · 对照排查:查询可过账资产60000011(公司代码1000)与报错资产60000171对比(API_FIXEDASSET_SRV/FixedAsset),唯一实质差异为基准计量单位 BaseUnitSAPCode:60000011=空(不按数量管理,242不校验数量,可正常过账);60000171=SET(按数量管理,数量字段=0.000,242过账触发AAPO/233数量校验失败)。其余字段(资产类别Z601/屏幕布局SAP_AUC/账本0L-4G已资本化)两资产一致。
- 2026-08-14 · 周杰 · [API对比(含60000178)+用户确认] · 修正结论(第二轮对比含60000178):60000178 同样 BaseUnitSAPCode=SET 但 242 可成功过账,故第一版“SET基准单位是根因”不成立,予以修正。真实差异:60000171 是唯一已发生首笔成本入账的资产(FixedAssetLedger FirstAcquisitionFiscalYear=2026/07、CapitalizationDate=2026-07-04、DepreciationStartDate=2026-08-01,AssetLifecycleStatus=4,无 AssetDeactivationDate,LegacyMasterFixedAsset=02.002.085);60000178/60000011 均未入账(FirstAcq=0000,LifecycleStatus=5)。需说明:用户确认 60000171 未转固(仍为在建工程AUC),上述 FirstAcquisition 仅为首笔成本归集入账、非转固。用户进一步提供:60000171 的价值是从另一资产转移而来(资产间转移只转价值、不携带数量),故资产账数量恒为 0;且 Manage Fixed Assets(F1600) 无修改资产数量的功能,数量只能靠带数量的过账累积。根因链:价值经资产转移入账(不带数量) → 按基准单位SET校验的数量=0.000 → 242过账触发 AAPO/233 数量不足报错。建议方向:由 FI 顾问确认补数量方案(带数量的资产过账)或调整业务路径(改走无数量校验的物料/资产过账方式)。
---
id: ISS-MJS-071
project: Majesty
title: 销售运费结算过账报错-结算凭证日期未填
raised_dept: ""
raised_by: ""
owner: 周杰 <jie.zhou@boscloud.cn>
owner_history:
- {from: 周杰, to: 周杰 <jie.zhou@boscloud.cn>, by: 周杰, date: 2026-08-14, reason: 新建指派}
system: SAP
registered: 2026-08-14
category: 用户操作问题
priority:
sap_status: 已完成
acceptance: 待验证
plan_date: 2026-08-14
developer: ""
attachments: []
source: 销售运费结算过账报错
linked: []
---
# ISS-MJS-071 销售运费结算过账报错-结算凭证日期未填
## 问题描述
销售运费结算(FS-7, 自定义Fiori ZUI_YFJS_01)上传结算数据后过账失败,OData错误批:
- FINS_ACDOC_CUST/252 激活公司代码验证(成本控制范围 A000/会计年度空)
- F5/507 会计科目在会计科目表 YCOA 未定义
- FAGL_ORG_UNITS/001 成本控制范围 A000 未找到利润中心 MJS00
- FF/825 公司代码 2000 事务 FTXP 税码 V0/V1/VA 未定义税率
- FOT_TDT/012 税码 V0/V1/VA 关键日期为空、不在任何有效期内
- RW/602 参数 ACCOUNTPAYABLE/ACCOUNTTAX/ACCOUNTGL 缺少字段 PSTNG_DATE
- RW/609 凭证错误 BKPFF
根因(已验证):结算模板的"结算凭证日期"未填写,导致过账请求 PSTNG_DATE 为空,税码校验、会计年度判定、公司代码激活校验全线失败(FOT_TDT/012 关键日期显示空白)。
处理:在结算模板补齐"结算凭证日期"(YYYYMMDD)后重新上传,过账成功,问题解决。
备注:本批报错与《日记账分录创建API_成功入参_0100000035.md》§5.1 已知失败点(FF825+FOT_TDT012+F5 507)高度吻合;科目YCOA、利润中心MJS00、税码V0/V1/VA为公司2000配置项,若后续单独触发需按配置核查。
## 当前方案
## 进展日志
- 2026-08-14 · 周杰 · [销售运费结算过账报错] · 创建问题;sap_status=已完成, acceptance=待验证;owner=周杰→周杰 <jie.zhou@boscloud.cn>(新建指派)
This source diff could not be displayed because it is too large. You can view the blob instead.
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