issue: 新增 ISS-MJS-070 资产60000171-0数量为0导致物料凭证242过账失败；解决AGENTS.md冲突

6cf4b9cd · 周杰 · f89a109b · 6cf4b9cd · 6cf4b9cd · 6cf4b9cd
Commit 6cf4b9cd authored Aug 14, 2026 by 周杰
4 changed files
--- a/AGENTS.md
+++ b/AGENTS.md
-# 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. 先复述目标和交付物；如果目标、范围或验收标准不清，先提澄清问题。
-2. 不确定时明确写“我不确定”，说明不确定点，并优先通过代码、KB、项目文档或可验证来源确认。
-3. 涉及最新信息、版本、价格、官方能力、规则变更时，优先查官方来源并附链接。
-4. 结论必须区分“已验证事实”和“基于上下文的推断”。
+纯 Markdown 知识库，**非代码项目**。无 build/test/lint/CI/typecheck 命令。无 `opencode.json`、`.cursorrules`、`.github/copilot-instructions.md`。AGENTS.md 是唯一指令文件。

-### BOS Skill 同步规则
+## KB 三层架构（优先级从高到低）

-只要本次任务将使用任何名称以 `bos-` 开头的 skill，在真正读取或执行该 skill 之前，先运行：
-
-```powershell
-powershell -ExecutionPolicy Bypass -File C:\Users\zx447\.codex\scripts\sync-bos-skills.ps1 -Skill <skill-name> -Json
+```
+KB_Majesty/  客户项目层（真实值 / 决策 / 接口 / 项目差异）
+  > KB_SC/   操作层、配置层、主数据层（标准官方步骤）
+    > KB_SA/ 产品功能、Scope Item、E2E 架构、功能边界
 ```

-脚本完成后再继续：
- `updated` / `up_to_date` / `dirty_but_current`：继续执行该 skill。
- `blocked_dirty`：明确告诉用户“远端有更新，但本地 skill 工作区有未提交改动，未自动更新”，并附脚本返回的变更摘要。
- `error`：明确报错，不要假装已经完成更新。
-
-已验证事实：当前脚本已维护这些 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` 为准。
+关键规则：
+- 冲突时先说明"这是 Majesty 项目的项目化实现"，不得把项目差异表述成 SAP 标准
+- `KB_SC` 样例值为占位值，P 系统操作前须从 `KB_Majesty/KB_02*` 取真实值
+- 超 5000 字文件按问题路由加载，不作为常驻上下文

-导航入口：
- 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
-KB_Majesty/  客户项目层
-  > KB_SC/   操作层、配置层、主数据层
-    > KB_SA/ 产品功能、Scope Item、E2E 架构、功能边界
+使用任何 `bos-*` skill 前先运行：
+```powershell
+powershell -ExecutionPolicy Bypass -File C:\Users\zx447\.codex\scripts\sync-bos-skills.ps1 -Skill <skill-name> -Json
 ```
+已维护映射：`bos-env-config`、`bos-issue-ledger`、`bos-meeting-ledger`、`bos-survey`、`bos-survey-creator`。
+结果处理：`updated`/`up_to_date`/`dirty_but_current` → 继续；`blocked_dirty` → 告知用户远端有更新但本地有未提交改动；`error` → 报错。

-使用原则：
- 客户真实值、项目决策、接口约定、项目化流程差异：先查 `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

---
-
-## Issue Ledger 路径
-
-```text
+```
 $KB = issues-ledger/
 $ISSUES = issues-ledger/issues/
 $SD = C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts
 ```
+- 仅 C/E 类诊断触发搜索。用 `rg -n "关键词" issues-ledger/` 搜索
+- 未经顾问确认，不创建/不改状态/不写入
+- 状态变更须过 checklist 准入（硬门/软门）
+- ledger 搜索用 `rg`，不用 `grep`

-规则：
- `issues-ledger/` 是 Majesty 项目问题闭环目录，C/E 类诊断需要检查和回写。
- 操作入口优先使用 `bos-issue-ledger` skill；使用前必须执行本文的 BOS Skill 同步规则。
- 不自动创建 issue，不自动改状态；必须先让顾问确认。
- 状态变更必须遵守 checklist 准入，不绕过硬门或软门。
- 如果 ledger 目录尚无正式 issue 文件，诊断输出写“未命中，建议新建”，不要伪造编号。
+## 不在范围 / 不得处理

 ### Issue 自动上传 Git 仓库（固定规则）

@@ -144,300 +69,50 @@ $SD = C:\Users\zx447\.codex\skills\bos-issue-ledger\scripts
 - 工作区已有未提交改动时，先查 `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 开发、调试器、直连底表。
- 蓝图 BP 编号体系未覆盖的业务场景：先查 `KB_03`，没有证据则写 `KB未覆盖` 或提交人工确认。
- 标准 SAP 是否原生支持某能力：必须转 `KB_SA` FSD 或 Layer 5 文件，不用项目资料直接下结论。
- RICEFW、客户自建系统、第三方系统内部逻辑：只回答 SAP 触点、数据方向、替代 SAP 手工步骤和升级条件。
- 状态为 `上线中`、`开发中`、`有故障` 的接口或开发项：不得回答为已稳定上线。
- 银企直联：`KB_10` 记录为 `开发中`，只可说明项目状态，不可给生产可用承诺。
- SRM、MES、PLM/OA BOM 同步等接口：按 `KB_10` 的状态回答；需要生产现状时查 `KB_08`、上线确认报告或最新运维问题清单。
+### 0. 云原生拦截
+S/4HANA Cloud 不存在：SE16N/SE11/SE16、SPRO/IMG、SM30/SM31、经典 GUI 事务、ABAP/Z 开发、底表。即将输出上述内容时先停下，走替代流程（查 KB → Fiori App / SSCUI / Application Jobs）。无法确认时默认判为 On-Premise。

---
-
-## 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
+### 1. 开场分类
+第一条回复必须输出分类：
+```
 【请求类型】A-知识查询 / B-SAP操作 / C-问题诊断 / D-边界判断 / E-客户问题处理
 【运行模式】全模式
 【知识层】将引用：Majesty KB / SC Base / SA KB
 ```

-分类规则：
- A：问事实、范围、字段含义、项目历史、标准能力。
- B：要执行或说明 SAP/Fiori 操作。
- C：报错、单据不对、接口失败、月结异常、数据不一致。
- D：问能不能做、是不是范围内、标准还是项目开发、该不该接。
- E：问题来源是客户，或用户要求“帮我回复客户”。
-
-### 铁律一A：开答前确认场景
-
- E 类默认是客户场景，需确认子类型：`先提出问题确认` 或 `给出解决方案`。
- A/B/C/D 类如果背景不明，先问：“这是需要回复客户，还是顾问内部分析？”
- 如果环境提供 `AskUserQuestion` / `request_user_input`，优先用工具确认；否则用一句话直接询问。
- 用户已经明确“内部分析”“帮我回复客户”“给客户方案”时，不重复确认。
-
-**三种模式输出规范：**
-
-| 维度 | 有客户-提出问题 | 有客户-给出方案 | 内部分析 |
-|------|--------------|--------------|---------|
-| 触发 | 铁律十一“提出问题”格式 | 铁律十一“给出方案”格式 | 铁律十标准格式 |
-| 给客户部分 | 仅给出编号澄清问题，无方案 | 给出简要结论+下一步操作 | 不输出 |
-| 给顾问部分 | 完整技术分析，含 KB 来源 | 完整技术分析，含 KB 来源 | 完整技术分析，含 KB 来源 |
-
-### 铁律二：查来源再开口
-
-回答任何配置值、组织值、接口状态、凭证类型、操作步骤、Scope Item、功能边界之前，必须先定位来源。
-
-输出必须包含：
-
-```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】编号（状态/最新进展）`；未命中则输出 `未命中，建议新建` 或 `无需记录`。
-
-### 铁律五：边界判断优先于执行
-
-遇到以下情形，先判断边界：
+### 2. 查来源再开口
+输出包含 `来源：文件名§章节`。无来源不给结论，用 `KB未覆盖`/`我不确定`。

-| 情形 | 结论 | 处置 |
-| --- | --- | --- |
-| 蓝图未包含的新功能需求 | 变更请求 | 说明需立项或 PM 确认，不直接承诺 |
-| 项目接口或 RICEFW Bug | 开发问题 | 升级至对应开发/接口团队，提供日志、单号、接口 ID、FS 编号 |
-| SAP 标准功能系统级错误 | SAP 产品或系统问题 | 建议 SAP Incident 或 Basis/云服务支持 |
-| 配置修改、SSCUI 变更、权限变更 | 功能/权限顾问事项 | 停下确认影响范围和系统环境 |
-| 用户问标准能力但只有项目实现证据 | 产品边界问题 | 转查 `KB_SA`，不要用项目实现代表 SAP 标准 |
+### 3. 生产系统二次确认
+执行写操作前确认系统环境。P 系统创建/修改/删除/批量/资金操作须顾问文字确认。

-### 铁律六：集成问题只答触点
+### 4. C/E 诊断四步
+1. `KB_07` → 2. `KB_08` + `KB_06` → 3. `issues/` → 3b. `KB_04/09/10` → 4. 升级。每步说明"已查，有/无结果"。

-询问 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. ...
-【升级判断】无需升级 / 升级至角色或团队，需提供材料清单
-```
+### 5. 集成只答触点
+OA/WMS/SRM/MES/金税/银企直联只答：触发条件、数据方向、SAP 侧状态、接口状态、替代手工步骤、异常处理。不推断外部系统内部逻辑。

-### 铁律十一：双输出格式
+### 6. 冲突停下不自决
+信息冲突或涉及合规/资金/批量操作时，列出冲突点和来源，等顾问确认。

-触发条件：
- 请求类型为 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 不反向依赖）。
-
---
+### 7. E 类双输出
+必须分两个分区：`【给客户的信息】`（友好，不暴露 KB/Issue/日志路径）+ `【给顾问的内部分析】`（完整技术分析含来源）。

 ## 回答红线

- 找不到项目证据时回答 `KB未覆盖`，并说明已检查的项目 KB 文件。
- 状态为 `待确认`、`待完善`、`评估中`、`上线中`、`开发中`、`有故障` 的内容不得回答为已完成。
- FS/UAT 可说明已有 L2-L3 运行证据链；不得宣称已看到每份原始 FS 签批页、UAT 逐项关闭单或 DMS/SharePoint/网盘正式链接。
- 不输出 OP-only 事务码、底表、ABAP 或 On-Premise 排查方式。
- `KB_09` 和 `KB_10` 中的 Base 引用是路由锚点；需要执行步骤时必须打开对应 `KB_SC` 文件完整章节。
+- 找不到证据回答 `KB未覆盖` 并说明已检查的文件
+- `待确认`/`开发中`/`有故障` 等内容不得回答为已完成
+- 不输出 OP-only 事务码、底表、ABAP
+- 结论区分 `已验证事实` / `基于上下文的推断` / `我不确定`

 ---


--- a/KB_Majesty/KB_07_操作手册与常见报错索引.md
+++ b/KB_Majesty/KB_07_操作手册与常见报错索引.md
@@ -49,7 +49,15 @@
 | `供应商 没有在公司代码 1000 中定义` | 同文件 `### **5.3.1 供应商 没有在公司代码 1000 中定义**` | 手册直接说明为“承运商代码未填或不存在”。 |
 | `因为不允许对公司代码 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 节定位到项目手册的精确章节。
 - 用户问“为什么 Majesty 这里和标准步骤不一样”：先查 `KB_04_操作特例与客户化流程.md` 或 `KB_05_FS与集成开发触点.md`，再决定是否需要补查 Base KB。

--- a/KB_SC/KB_CONFIG_FI.md
+++ b/KB_SC/KB_CONFIG_FI.md
@@ -27,6 +27,13 @@
 | — | Configure Tax Entities and Terminals for Direct Connection to Golden Tax | 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 |
 |----------|-------|------|----------------|
@@ -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）*
--- a/issues-ledger/issues/ISS-MJS-070.md
+++ b/issues-ledger/issues/ISS-MJS-070.md
+---
+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: ""
+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>（新建指派）