同步员工报销填报指南与 B2 口径（08-30-reimbursement-employee-guide-b2-sync）

2026-08-30 15:19:20 +08:00
@@ -20,7 +20,8 @@
  "subtasks": [],
  "children": [
    "08-30-reimbursement-expense-policy-invoice-guard-deploy",
-    "08-30-reimbursement-assets-prior-approval-correction"
+    "08-30-reimbursement-assets-prior-approval-correction",
+    "08-30-reimbursement-employee-guide-b2-sync"
  ],
  "parent": null,
  "relatedFiles": [
@@ -0,0 +1 @@
+{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
@@ -0,0 +1 @@
+{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}
@@ -0,0 +1,63 @@
+# 同步员工报销填报指南与 B2 规则
+
+## Goal
+
+让员工侧主手册准确反映已经全局生效的票据—明细门禁和人工填报粒度要求，避免员工按旧文案误以为“金额超票面后写说明即可提交”，同时允许住宿、月度通讯费、服务期费用等连续跨天或跨期支出作为同一笔业务支出填一条明细。
+
+## Background
+
+- `docs/员工快速上手.md:41-68` 是当前员工使用说明；第 6 节已有 PDF-only、图片走附件、支付截图、补助和差旅专项规则，不应重复另建“报销填报说明”。
+- `docs/员工快速上手.md:65` 仍写“原则上不得超过有效发票金额，差异必须说明”。B2 全局生效后，需要发票的明细金额高于关联发票票面合计会被硬阻断，仅写说明不能提交。
+- B2 只校验发票是否关联、需票明细是否有金额有效的关联发票、明细金额是否高于关联票面合计；它不校验费用类型、发生日期或业务支出粒度。明细拆分属于员工填报要求和财务人工复核事项，不得宣称系统会自动提醒或阻断。
+- 发生日期是实际费用发生或消费日期，不是报销提交日期，也不能一律由发票日期替代；与发票日期不一致时应说明原因。
+- 连续跨天或跨期的同一笔业务支出（如多晚住宿、月度通讯费、按服务期计费）可以作为一条明细，并在说明中写清起止日期。
+- 只改员工手册会产生事实源冲突：`docs/报销发票附件规则.md:151` 仍保留“原则上不得超过、差异说明”，`:155` 仍把“一条明细”绝对限定为同一发生日期；`:156` 又已经记录 B2 超票面硬阻断。
+
+## Scope
+
+- 员工侧主手册中的通用报销填报规则与差旅指南第 8 条。
+- 报销发票附件事实源中与金额硬门禁、连续跨期粒度直接冲突的两条现行口径。
+- Trellis task 元数据与文档一致性验证。
+
+## Requirements
+
+### R1 员工手册增加最小通用规则
+
+- 在 `docs/员工快速上手.md` 第 6 节、现有“差旅报销一页指南”之前增加“通用报销填报规则”。
+- 只补现有差旅段落没有覆盖的内容：同一费用类型和同一笔业务支出的明细粒度、连续跨期例外、实际发生日期口径、逐票关联、需票明细的金额硬门禁，以及退回后“先移除发票—再改明细—最后重新添加并选择明细”的顺序。
+- 图片、截图和拍照材料不得从正式发票入口上传；属于支付证明、订单或情况说明时，通过“上传附件”提交。不得写成图片材料一律无效。
+- 明确粒度要求由员工遵守、财务复核，B2 不自动比对日期或判断拆分是否正确。
+
+### R2 纠正差旅指南第 8 条
+
+- 把 `docs/员工快速上手.md:65` 改为：需要发票的实报实销明细金额不得高于关联发票票面合计，超出时系统阻止提交；优惠券、多人合并开票、部分自费等申报金额低于票面的情况仍需说明。
+- 保留已退款、公司直接支付、他人承担金额不得重复报销，以及缺支付截图时由财务决定是否接受其他证据、不得补造凭证的现有口径。
+
+### R3 最小同步主事实源
+
+- `docs/报销发票附件规则.md` 是产品/财务事实源而非员工手册，不复制员工操作说明。
+- 其 `:151/:155` 与本任务已确认的新口径冲突；同一 task 内只做两处最小事实纠偏，避免员工手册与主事实源互相矛盾：金额规则改为需票明细超关联票面硬阻断，粒度规则补充连续跨天/跨期同一业务支出的例外及起止日期说明。
+- 不修改 `docs/trialrun/R7用户手册与FAQ.md`；该文档仍是草案，不是当前员工主说明。
+
+## Acceptance Criteria
+
+- [x] 不新建说明文档；员工通用规则落在现有 `docs/员工快速上手.md` 第 6 节且不重复现有差旅指南。
+- [x] 通用规则正确区分实际发生日期、发票日期和报销提交日期，并明确连续跨天/跨期的同一业务支出可以一条明细记录起止日期。
+- [x] 文档明确 B2 的三项系统门禁及其日期/粒度非目标；员工不会被告知“系统会自动检查拆分是否正确”。
+- [x] 需要发票的明细金额高于关联票面合计被表述为硬阻断；说明仅用于允许提交的票面高于申报金额等差异场景。
+- [x] 退回修改顺序、正式 PDF 入口和图片附件路径表述准确。
+- [x] `docs/员工快速上手.md` 与 `docs/报销发票附件规则.md` 不保留互相矛盾的生效规则。
+- [x] `node scripts/qa/audit-docs.mjs --check-registry`、`node scripts/qa/check-trellis-governance.mjs` 和 `git diff --check` 全部通过。
+
+## Out of Scope
+
+- 不修改应用代码、自动化测试或运行配置，不执行线上写入或发布。
+- 不新建报销说明文档，不改 `docs/trialrun/R7用户手册与FAQ.md`。
+- 不处理费用类型命名、会计科目映射、固定资产政策或四张真人报销的退回操作。
+
+## Test Plan
+
+- 逐条对照 B2 已生效合同，检查员工手册与报销事实源的金额、关联、免票和粒度边界不存在矛盾。
+- 运行 `node scripts/qa/audit-docs.mjs --check-registry`。
+- 运行 `node scripts/qa/check-trellis-governance.mjs`。
+- 运行 `git diff --check`。
@@ -0,0 +1,29 @@
+{
+  "id": "reimbursement-employee-guide-b2-sync",
+  "name": "reimbursement-employee-guide-b2-sync",
+  "title": "同步员工报销填报指南与 B2 规则",
+  "description": "同步员工快速上手中的通用报销填报规则与已全局生效的 B2 门禁，纠正差旅金额旧口径，并处理连续跨期支出的明细粒度表达。",
+  "status": "in_progress",
+  "dev_type": null,
+  "scope": "employee reimbursement guide; reimbursement documentation consistency",
+  "package": "docs",
+  "priority": "P1",
+  "creator": "shunli",
+  "assignee": "shunli",
+  "createdAt": "2026-08-30",
+  "completedAt": null,
+  "branch": null,
+  "base_branch": "main",
+  "worktree_path": null,
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "children": [],
+  "parent": "08-29-reimbursement-expense-policy-invoice-guard",
+  "relatedFiles": [
+    "docs/员工快速上手.md",
+    "docs/报销发票附件规则.md"
+  ],
+  "notes": "文档专项目标，不改应用、不执行线上发布或写入；四张真人报销的退回与通知不依赖本任务。",
+  "meta": {}
+}
@@ -49,6 +49,15 @@
 - OAOPS1 期间请用真实业务数据完成报销、采购/费用、合同台账和项目关联；遇到提交、审批、付款、导出或权限阻断时，记录页面、步骤和影响等级，让管理员当天建修复合同或暂停对应流程。
 - OALAUNCH1 收口期内，请把真实业务问题按“阻断 / 非阻断 / 建议”告诉管理员；不要只在聊天里说“系统有问题”。阻断包括无法提交、无法审批、付款/AP 无法闭环、越权可见、合同或资产敏感信息泄露、备份恢复或导出证据缺失。

+### 通用报销填报规则
+
+- 一条明细应表达同一费用类型和同一笔业务支出。不同类型或彼此独立的支出必须分开填写；连续跨天或跨期的同一笔支出（如多晚住宿、月度通讯费、按服务期计费）可以填写一条明细，并在说明中写清起止日期。
+- 发生日期填写实际费用发生或消费日期，不是提交报销的日期，也不一定等于发票日期；与发票日期不一致时，在说明中写清原因。
+- 上述明细粒度和日期口径是员工填报要求，由财务复核。系统不会自动比对日期，也不会判断明细拆分是否正确。
+- 每张有效发票都必须关联到一条明细。正式发票入口只接受官方 PDF；图片、截图和拍照材料不能从该入口上传，支付证明、订单或情况说明等材料应通过“上传附件 / 补充材料”提交。
+- 提交时，系统会检查已添加的发票是否都已关联明细、需要发票的明细是否有票面金额有效的关联发票，以及明细金额是否高于关联发票的票面合计。金额超出时系统会阻止提交，仅在说明中解释差额不能通过；申报金额低于票面合计（如使用优惠券、多人合并开票或部分自费）时仍需说明原因。
+- 报销被退回后需要调整明细时，请先在“报销材料”中逐张移除发票，再拆分、删除或修改明细，最后重新添加发票并为每张发票选择对应明细。不要先删除仍挂有发票的明细，否则发票可能变成无法重新选择的未归属状态。
+
 ### 差旅报销一页指南

 1. 从企业微信工作台进入海音达工作台，打开 `报销`，新建报销单。
@@ -62,7 +71,7 @@
 5. 支付截图应看得出商户、金额、支付时间和支付成功状态；银行卡号、支付账号、订单号等与复核无关的信息先遮挡。
 6. 补助按自然日计算：出发日、返回日各计 1 天，当天往返计 1 天；因个人原因延长的天数不计。公司或其他单位已直接承担餐食或车辆费用的，对应补助不得重复领取。
 7. 伙食补助和市内交通补助均为包干：领取伙食补助后个人餐费不得另报；领取市内交通补助后，出差期间公交、地铁、出租车、网约车等不得另报。城际交通、住宿及其他经批准的必要差旅费用凭有效材料实报实销。
-8. 实报实销明细填写个人实际支付的合规金额，原则上不得超过有效发票金额。优惠券、多人合并开票、部分自费或发票金额与实付金额不一致时，必须说明；已退款、公司直接支付或他人承担的金额不能再次报销。无法提供支付截图时上传情况说明，由财务决定是否例外接受，不得补造凭证。
+8. 需要发票的实报实销明细填写个人实际支付的合规金额，不得高于关联发票的票面合计，超出时系统会阻止提交。使用优惠券、多人合并开票或部分自费等导致申报金额低于票面合计时，仍需在说明中写清原因；已退款、公司直接支付或他人承担的金额不能再次报销。无法提供支付截图时上传情况说明，由财务决定是否接受其他证据，不得补造凭证。
 9. 提交前检查各项明细、对应 PDF、火车票和住宿费支付证明以及补助算式。提交后由直属主管审批、财务复核；实际付款和付款回单由财务处理，员工不预填。

 OCR 会辅助识别发票字段和查重，但不代表系统已经确认费用真实合规。财务仍会同时核对明细金额、PDF 原件和个人支付证明；三者不一致时会退回补充或更正。
@@ -148,11 +148,11 @@ R5 公网验收后确认：正式发票/OCR 上传入口只接受 PDF 发票文
 - 火车电子票据、住宿电子普通发票等正式票据必须使用官方 PDF，从对应明细的发票入口上传并绑定；发票截图、支付截图或拍照图片不得冒充正式发票。
 - 火车票和住宿费均必须提供个人支付截图。支付截图属于整张报销单的补充附件，不绑定到发票记录；文件名或附件说明必须能对应到具体费用明细。
 - 支付截图保留商户、金额、支付时间和支付成功状态即可；银行卡号、支付账号、订单号等与审批无关的信息应先遮挡，不要求员工提供完整支付账户或银行流水。
- 明细金额以员工个人实际支付的合规金额为准，原则上不得超过有效发票金额。优惠券、多人合并开票、部分自费、票面金额与实付金额不一致等情况必须在明细说明中写明差异。
+- 明细金额以员工个人实际支付的合规金额为准；需要发票的明细金额不得高于该明细关联发票的票面合计，超出时系统阻断提交。优惠券、多人合并开票、部分自费等导致申报金额低于票面合计时，必须在明细说明中写明差异。
 - 已退款、公司直接支付或由他人承担的金额不得重复报销。发生部分退款时，只能申报扣除退款后的个人实际承担金额，并附情况说明。
 - 确实无法提供支付截图时，员工必须上传情况说明；财务可以退回补充，也可以在有其他充分证据时例外接受并留痕。不得伪造、补造或借用他人支付凭证。
 - OCR 只辅助识别发票字段、匹配和查重，不判断支付真实性、费用合理性或发票法律状态。财务复核时必须同时查看明细金额、PDF 原件和个人支付证明；三者不一致时退回更正或补充说明。
- 每张有效发票应关联到一条明确费用明细。一条明细只表达同一费用类型、同一发生日期和同一业务支出；采购物品还应是一件或一批同类物品，不同日期、不同支出或需要分别判断设备提示的多件物品应拆分。
+- 每张有效发票应关联到一条明确费用明细。一条明细只表达同一费用类型和同一笔业务支出；不同类型或彼此独立的支出应拆分，采购物品还应是一件或一批同类物品。连续跨天或跨期的同一笔业务支出（如多晚住宿、月度通讯费、按服务期计费）可以作为一条明细，并在说明中写清起止日期。
 - 票据—明细门禁启用后，需票明细没有有效发票或申报金额高于关联票面合计时阻断提交；两项包干补助不参加票面比较。关闭门禁不会删除或解绑已经建立的关联关系。
 - 财务付款凭证号、付款日期、付款渠道和付款回单属于审批通过后的财务处理，不是员工提交报销时填写的个人支付证明。
				`@@ -0,0 +1 @@`
				{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}