报销助理-多币种 · Reimbursement Assistant (Multicurrency)

技能定位

接收用户手里一堆零散的单据（扫描件、照片、PDF），自动完成识别抽取 → 归档附件 → 查重核对 → 费用归类（含多币种处理）→ 出报销单，生成一张可直接提交的分类汇总报销单；并把原始票据文件作为附件，与报销单表格的每一行一一对应——既能点开看原件，也能按编号对纸质票。

一句话流程：收票据 → 识别抽取 → 归档附件 → 查重核对 → 费用归类（含多币种）→ 出报销单。

> 能力边界说明：本技能做"票据信息整理与汇总的辅助结果"，不做发票真伪核验、跨境税务抵扣判定、汇兑损益账务处理、购汇/结汇合规判定、财务审计结论、企业账务入账。遇到这些要明确告知用户"超出本技能范围，需人工或专业系统处理"。

核心能力速览（打开本技能先看到这里）

把"一堆零散票据"变成"一张可直接提交的分类汇总报销单"。两大能力板块，打开即用：

🧾 单据识别 · 自动查重 · 费用归类

💱 多币种折算汇总 · 数据透视 · 明细输出

> 想看完整流程、字段定义与汇率取数逻辑，见下方「四、执行步骤」「五、费用类别」「九、多币种与汇率处理」等章节。

一、什么时候触发（与不触发）

触发（中英文均可，含以下任一意思）：报销、做报销单、整理发票、发票归类、行程单汇总、票据识别、费用汇总、帮我贴票算账、票据和表格对不上、我要能看到每张票的原件、外币报销怎么算/汇率怎么折算；英文如 expense report、receipt OCR、multi-currency expense、invoice classification。

不触发：用户只是在聊"报销制度"等泛话题，或在做与票据文件无关的纯财务计算时，不启动本技能，避免误触发浪费资源。

二、需要用户提供什么

1. 单据文件：图片（jpg/png/扫描件）和 PDF（电子发票、行程单、银行回单等）。可一次性给一批文件，也可只给一个文件夹路径。
2. 报销头信息：报销人、部门、报销期间（哪个月或哪个项目）。用户没给的要主动问，不要自己编。
3. 格式要求：见「六、输出格式优先级」。
4. 币种处理意向：默认人民币。开始整理前应提示用户一句"本批是否含外币单据"；一旦发现非人民币单据，必须先与用户确认单列或折算（见「九、多币种」）。

> 如果用户根本没给单据文件，停下来向他要，不要凭空编数据。

三、支持的单据类型与抽取字段

支持（清单可扩展，清单外也尽力识别）：增值税专用发票、增值税电子普通发票 / 数电票（全电发票）、网约车行程单（滴滴、高德等）、铁路电子客票（火车票）、航空运输电子客票行程单（机票）、出租车票、定额发票、收据 / 零星小额采购小票、银行回单 / 支付凭证、以及其他自定义单据（含境外商家开具的外币单据）。

每份单据统一抽取以下字段（字段名为脚本 reimbursement_builder.py 采用的英文键，详见「十七、字段 Schema 速查」）：

抽取规则：
- 图片类直接用视觉能力逐张读取；PDF 类先抽文本，抽不到或属扫描件则把页面转图片再识别。
- 多页 PDF 一页多票：逐页/逐票拆分识别，不要整份当一张。
- 一张行程单含多笔行程：默认整单作一行，摘要写"含 N 笔行程"；用户要求拆分明细才逐笔成行。
- 抽完把每行价税合计加总一次，和票面总额对一遍，明显不符回去重看。
- 拿不到、认不清的字段一律留空，置信度标"中"或"低"，绝不猜数字、编内容。
- 红冲/负数票据照实记负值，备注写"红冲/负数"，不得取绝对值。
- 外币单据金额一律照票面原币记录，抽取阶段不自行换算；折算与否、用哪个汇率按「九」走。

四、执行步骤（操作手册）

步骤 0 · 收集输入与确认格式

• 拿到单据文件（或文件夹路径）。没有文件 → 停下来要文件。
• 问清报销人、部门、报销期间；缺则问。
• 按「六」确认格式：用户已指定 → 直接用；未指定 → 只提示一次是否公司有模板，没有/看着办 → 走默认格式（八）。

步骤 1 · 识别抽取

• 图片：用多模态视觉能力逐张读取，按「三」字段表抽取。
• PDF：优先 pdfplumber/PyMuPDF 抽文本；抽不到或扫描件 → 转图片后用视觉能力识别。多页多票逐票拆分。
• 每张票产出一条记录；抽不清的字段留空 + 置信度中/低。

步骤 2 · 组装 单据数据_<期间>.json

把全部记录 + 头信息 + 配置写入 JSON（Schema 见「十七」）。此文件是识别结果与出表之间的中间产物，也是复核依据。

步骤 3 · 多币种确认（仅当存在非人民币单据）

严格按「九」执行：先提示币种与张数 → 请用户二选一（单列 / 折算）→ 折算时优先用用户汇率，无汇率且用户同意才联网查央行中间价。把结论（mode + 各币种汇率 + 来源）写回 JSON 的 meta。

步骤 4 · 运行生成脚本

python scripts/reimbursement_builder.py --data 单据数据_<期间>.json --out <输出目录> [--template <模板.xlsx>]

• 套模板：--template 指定用户模板，按模板表头下方填数据、末尾追加合计行，不改模板结构；无模板则生成内置 4~5 张表。
• 脚本负责：查重、归类、多币种折算、生成 Excel、复制附件到 附件/ 并写相对路径超链接、金额大写、自检。
• 不整理附件时：JSON meta.build_attachments=false，跳过附件列与票据索引表。

步骤 5 · 自检（硬性，不通过不交付）

脚本内置自检：① 文件已写、非空、可打开；② 用户给了原件则 附件/ 已生成且明细超链接可点开；③ 汇总金额与明细逐行加总一致；④ 无公式错误；⑤ 外币行汇率来源已标注。任一不通过 → 修完重跑。

步骤 6 · 交付话术（见「十二、交付契约」与「话术要求」）

在最终回复给出真实文件路径，并说清：收了几张单据 / 人民币合计 / 外币 M 张（各币种原币共多少，折算则折后合计多少）/ 归了哪几类 / K 条异常（列出哪几条、为什么）/ 附件对应 N/M 份 / 外币单列还是折算、汇率来源。

五、费用类别与归类规则

默认类别（可配置，用户给了科目表就按用户的归）：
市内交通费、差旅费、办公费、业务招待费、通讯费、会务与培训费、低值易耗与零星采购、其他。

归类要点：
- 同一趟出差期间的打车、住宿、机票火车票（含境外差旅外币住宿/打车）随该趟归差旅费；市内日常办事打车归市内交通费——两类不混。
- 小额零星采购、无发票的收据 → 低值易耗与零星采购。
- 冲突时优先按"业务实质"归，备注说明依据；定不了归其他。

六、输出格式优先级（务必按序）

1. 用户已指定格式 → 直接用
   - 给了 Excel 模板：按模板套填，数据填表头下方，末尾追加合计行，不改模板原有结构。
   - 只给文字说明（如"我要 5 列：日期、事项、类别、金额、备注，按日期排序"）：按其说明构造表头与列顺序。
2. 用户未指定 → 先提示一次：问是否公司有规定模板，有就发来套用（回到 1）。
   - 用户说没有 / "你看着办" → 走 3。
   - 用户暂未回复但有别的要求 → 先按默认出一版，说明"如需套用公司模板，把模板发我我再改"。
3. 确实没有 → 用「七」内置自动分类汇总格式。

> 只在用户没指定时提示一次；用户已说过没有，就不要反复追问。

七、默认输出结构（用户没指定格式时）

生成一个 Excel 报销单文件，含四张表，同目录生成 附件/ 文件夹。含外币时另加「外币单据」表（见九）。

> 每个工作表（页面）均带一行「金额汇总（合计）行」：表1 已有按类别的合计；表2 费用明细合计（仅计「计入合计=是」的行，与建议报销金额口径一致）；表3 异常与待确认在存在异常时合计「涉及金额」；表4 票据索引合计「价税合计 / 折算人民币」；表5 外币单据合计「折算人民币」并分币种列示原币。模板模式（六·1）亦在末尾追加合计行。

• 表1 报销单汇总：报销人、部门、报销期间、单据张数、生成时间；按费用类别列 单据张数/金额合计/占比，末尾合计行；再给「建议报销金额（剔除疑似重复和金额待确认）」「单据合计金额」「金额大写」「疑似重复单据张数」「原始票据附件对应情况」。含外币还须给：「外币处理方式（单列/折算）」「外币合计（按币种分列 张数与原币金额）」；折算方式再加「折算后人民币合计」。人民币合计与折后人民币合计都要与大写金额口径一致。
• 表2 费用明细（固定列，顺序不可打乱）：
  序号 | 来源文件 | 附件编号 | 票据附件 | 单据类型 | 开票日期 | 销售方名称 | 费用类别 | 摘要 | 币种 | 金额 | 税额 | 价税合计 | 汇率 | 折算人民币 | 汇率来源 | 是否可抵扣 | 发票代码 | 发票号码 | 识别置信度 | 是否重复 | 计入合计 | 校验状态 | 备注
  要求：首行冻结、首行自动筛选；金额类（金额/税额/价税合计/折算人民币）保留两位、汇率保留四位小数；附件编号形如 F-01；「票据附件」单元格显示"打开"且点击打开原件。人民币：币种 CNY、汇率 1、折算人民币=价税合计；外币：价税合计记原币、折算人民币记折后（未折算留空）。表末追加「合计」行：金额/税额/价税合计仅对人民币且计入合计的行求和，折算人民币对全部计入合计的行求和（= 建议报销金额），并与逐行加总自检一致。
• 表3 异常与待确认：序号 | 来源文件 | 问题说明 | 建议处理 | 涉及金额(价税合计)。挑出疑似重复、金额缺失、缺日期、缺销售方、置信度低、外币缺汇率无法折算、负数/红冲等行并给建议。无异常写一行"无异常"。
• 表4 票据索引：序号 | 附件编号 | 附件文件名 | 原件路径 | 单据类型 | 开票日期 | 销售方名称 | 币种 | 价税合计 | 折算人民币 | 是否计入合计 | 打开附件。每行对应一份原始票据，打开附件可点击。
• 表5 外币单据（仅含外币时）：序号 | 来源文件 | 单据类型 | 销售方名称 | 开票日期 | 币种 | 原币金额 | 汇率 | 汇率来源 | 折算人民币 | 是否计入人民币合计。集中列全部外币单据便于核对。表末「合计」行：折算人民币求和，原币金额按币种分列（如 USD230.00；EUR120.00）。

文件命名：报销单 报销单_<报销人>_<期间>.xlsx（期间形如 202609）；中间数据 单据数据_<期间>.json。用户指定了名字以用户为准。

八、原始票据与表格行的对应（重点需求）

两种方式，互为备份：

方式一 · 超链接（电子查看）
- 原始票据复制到报销单同级 附件/，重命名 <序号>_<原文件名>，序号补零（如 01_滴滴行程单_20260903.pdf）。
- 「费用明细」表「票据附件」列写超链接，单元格显示"打开"，指向 附件/01_滴滴行程单_20260903.pdf。
- 链接用相对路径（相对工作簿位置），整包移动/转发不失效。
- 「票据索引」表「打开附件」列同样带超链接。
- 兼容提示：桌面版 Excel/WPS 打开最稳；传到在线表格/手机端可能点不开，需告知"在线查看可能点不开，请下载后打开"。

方式二 · 编号索引（打印贴票）
- 每行给附件编号，从 F-01 起，与明细行序号一一对应。前缀与起始值可配置。
- 「票据索引」表把编号、文件名、原件路径、金额列齐；打印后按编号顺序贴票对号入座。

缺原件：某单据无 source_path 或文件已不存在 → 编号照给（保证连续），附件列显示「无原件」，绝不生成或伪造文件。交付如实告知"这一批对应上了 N/M 份，哪几行缺原件"。

不需要附件：用户明确说只要表格不要原件 → 跳过附件整理（不生成附件列和票据索引表），交付说明写清。

为什么复制副本：原件常散落在下载目录/微信文件夹，直接引用易失效、不便整包转发；复制成 附件/ 后报销单与附件是一个整体。复制是只读副本，不回写、不修改用户原件。

九、多币种与汇率处理（必须做到）

默认按人民币；发现非人民币单据，先与用户确认，不自行决定。

第一步 · 先提示、后动手
- 开始整理前提示："本批是否含外币单据？"
- 发现外币单据：告知币种与张数，请二选一：
"本批有 N 张非人民币单据（币种：USD/EUR/…）。请确认：① 外币部分单独列示、不折算；② 折算为人民币并入本单。若选②请提供汇率（如「1 美元=7.15 元」）；手上没有汇率的话，我可在你同意后去查中国人民银行公布的外汇中间价。"

第二步 · 按选择处理
- 方式 A 外币单列（不折算）：保留原币金额，不并入人民币合计；单列「外币单据」表（币种/原币金额/张数）；人民币合计只统计人民币单据；交付写"外币部分未折算，共 X 张、合计 Y（原币）"。
- 方式 B 折算为人民币：按第三步汇率来源取汇率，逐张折算后并入人民币合计。

第三步 · 折算汇率来源（严格按优先级）
1. 用户提供的汇率（最优先）——给了某币种汇率直接用；指定折算日期则按该日期取中间价。
2. 中国人民银行外汇中间价——仅在用户同意后联网查该币种对人民币中间价，数据来源为央行官网（https://www.pbc.gov.cn）公开发布的《人民币汇率中间价公告》。实现见 scripts/pbc_rate.py（标准库实现，无需第三方依赖）：抓取公告列表 → 按取价日期定位公告（开票日当日；周末/节假日未公布时自动取最近一个公布日；也可用户指定）→ 解析公告正文中的「N 外币对人民币 X 元」，日元按每 100 单位报价自动折算为每 1 单位。取价日期优先级：单据开票日 → 无当日中间价（周末/节假日/未公布）取最近一个公布日 → 用户另行指定折算日期按用户指定。若脚本运行环境无法直连央行（如证书拦截），也可由本助手用 WebFetch 读取公告页后把汇率写回 JSON 的 provided_rates，效果等价。
3. 汇率一律注明来源与日期，如"中国人民银行 2026-09-18 美元中间价 7.1500"或"用户提供 1 USD = 7.15 CNY"。

第四步 · 记录与透明（硬性）
- 每条外币记录落：币种、原币金额、汇率、汇率来源、折算人民币；一眼看出"哪个币种、什么汇率、哪一天"。
- 没汇率就不能折算：既无用户汇率、用户也不同意联网 → 保留原币、列入异常表、提示补汇率；绝不臆造汇率、凭印象猜。
- 折算结果保留两位小数；汇率舍入分位差异在备注注明。

第五步 · 其余规则
- 查重：外币按原币金额+币种比较，不拿折后金额比（汇率变会误判）。
- 汇总口径：汇总同时给「人民币合计」与「外币合计（分币种列示）」；方式 B 再给「折算后人民币合计」。
- 金额大写只对折算后人民币出具；方式 A 下注明"大写仅对应人民币部分，外币未折算"。
- 明确不做：跨境税务抵扣判定、汇兑损益账务处理、购汇/结汇合规判断，遇此提示走人工/专业系统。

十、查重与校验

• 唯一键：优先发票号码（同代码+号码即同一张）；无票号退化为「销售方+开票日期+金额+币种」四者相同。
• 疑似重复行保留在明细并标注，默认不计入建议报销金额，让用户定夺。
• 必填缺失 + 外币缺汇率等一并进异常表。
• 只做本地查重，不判定真伪——真伪须走税务官方查验平台，只能提示人工核验。

十一、稳健性边界（逐条落实）

• 加密/受密码保护 PDF：读不到则跳过，列入异常并提示"文件已加密，请解密后重新提供"，不反复重试或报错中断整批。
• 模糊/倾斜/手写体票据：尽力识别，置信度一律"低"，异常表提示人工复核。
• 单批数量大（上百份）：分批处理，避免一次加载过多中断；处理完给"共处理 N 份"统计。
• 年份跨期：按用户指定期间汇总，不按系统当前日期擅自分月。
• 零金额/赠票/免费票：照实记 0，备注说明。
• 同一文件重复提供：先按文件内容去重，避免同一份被识别两遍。
• 外币汇率取不到：见九第四步，保留原币、列异常、不编假汇率。
• 无法联网查中间价：环境不允许或查询失败 → 退回方式 A（外币单列），或请用户直接给汇率，不让整批失败。

十二、交付契约（硬性）

除非用户说"不用出文件""只在对话里给我看看"，否则必须真实产出 Excel 报销单（有原件时连同 附件/ 一起交付）。完成条件：
1. 报销单文件已真实写入工作区、非空、能被 Excel/WPS 打开；
2. 用户提供了原件时，附件/ 已生成，明细能点开对应文件；
3. 交付前跑过自检：文件可读、无公式错误、汇总与明细逐行一致、附件链接可用、外币行汇率来源已标注；
4. 最终回复给真实文件路径，并说明：收了几张单据、合计金额（人民币/各外币分别多少）、分了哪几类、几条异常、附件对应几份、外币单列还是折算；
5. 汇总数字与明细必须逐行可核对，不能"看着对、实际对不上"。

自检不通过就修完重跑，直到通过再交。

十三、边界与红线

• 不改原始单据：只在识别结果上汇总，附件/ 是只读副本，不回写、不修改原件。
• 不编造数据：拿不到金额/日期/商家就留空并标低置信度，绝不猜；没原件标"无原件"，不生成假文件；没汇率留空并进异常，绝不臆造。
• 不冒充查验结论：只做本地查重，真伪走税务官方查验平台。
• 不替用户决定汇率口径：单列还是折算、用哪个汇率，都要用户确认；央行中间价只在用户同意后查取并注明发布日期。
• 数据不外传：票据属敏感财务信息，只在当前工作区内处理；仅"查外汇中间价"在用户同意后联网，且只发币种与日期，不上传任何票据内容。
• 金额以票面为准：不替用户"凑数"或平账，对不上如实报告差异。
• 不越界给专业结论：不输出税务筹划、抵扣合规判定、审计意见、汇兑损益处理等。

十四、发布前脱敏要求（公开共享必做）

• 技能包内所有示例数据/示例票据/示例模板必须用虚构信息：假公司名、假人名、假发票号码、假金额、假汇率、假路径，不得带入任何真实个人/企业票据数据。
• 示例图片应为自制模拟票据（版式示意即可），不得用真实发票扫描件。
• 技能文档不得出现真实内网地址、账号、密钥、本机绝对路径等敏感信息。
• 发布时按平台要求完成合规自检（内容合规、不含隐私、敏感领域已附免责声明）。

十五、可配置项汇总（写在 skills 说明，用户可覆盖）

做成可配置（写进 meta 或命令行参数）：费用类别清单、附件编号前缀与起始值、是否整理票据附件、默认输出格式与文件命名规则、小数位、是否要求先询问公司模板；多币种相关——默认币种（人民币）、外币处理方式（先问用户/默认单列/默认折算）、是否允许联网查央行中间价（默认需用户同意）、取价日期口径（开票日/当前月1日/最近公布日/用户指定日）、汇率小数位（默认两位）。

十六、验收用例（examples/，可直接复现）

放入 examples/，保证可一键复现，每条含：输入文件、期望结果要点、实际结果。
1. 默认格式：示例数据 → 含四张表的报销单，附件全可点开，校验通过。
2. 指定模板：示例公司模板 → 按模板列序套填，原有列结构不变，附件列追加右侧，校验通过。
3. 重复票：含 1 张重复票据 → 标注疑似重复、不计入建议报销金额，异常表列出。
4. 缺原件：1 行无来源路径 → 附件列"无原件"，编号连续，交付如实告知。
5. 异常输入：加密 PDF 与低置信度模糊票各 1 份 → 不中断，均进异常表并给建议。
6. 多币种·折算：含 2 张美元单据、用户同意用央行中间价折算 → 明细币种=USD、价税合计原币、折算人民币为折后且注明来源与日期，外币合计与折后合计正确，另生成「外币单据」表，校验通过。
7. 多币种·单列：同批选"外币单列" → 人民币合计不含外币，外币在「外币单据」表单列，金额大写下注明"仅对应人民币部分"。
8. 外币缺汇率：1 张外币单据既无用户汇率、用户也不同意联网 → 保留原币、折算人民币留空、进异常表，明确提示补汇率，不得出现任何编造汇率。

十七、字段 Schema 速查（给 reimbursement_builder.py 用）

输入 JSON 结构：

{
  "meta": {
    "reimburser": "张三",
    "department": "市场部",
    "period": "202609",
    "currency_mode": null,            // "convert" | "single" | null(仅人民币)
    "template_path": null,            // 用户模板 xlsx 路径
    "attachment_prefix": "F-",        // 附件编号前缀
    "attachment_start": 1,            // 起始序号
    "build_attachments": true,        // 是否整理附件
    "company_categories": null,       // 用户科目表（字符串数组）或 null
    "provided_rates": {},             // {"USD": {"rate": 7.15, "source": "用户提供", "date": "2026-09-18"}}
    "rate_fetch_allowed": false,      // 是否允许联网查央行中间价
    "decimal_places": 2,
    "rate_decimal_places": 4
  },
  "records": [
    {
      "source_file": "滴滴行程单_20260903.pdf",
      "source_path": "C:/.../滴滴行程单_20260903.pdf",
      "receipt_type": "网约车行程单",
      "invoice_date": "2026-09-03",
      "seller": "北京小桔科技有限公司",
      "category": null,
      "summary": "市内办事打车",
      "currency": "CNY",
      "amount_excl_tax": 0.0,
      "tax_amount": 0.0,
      "total_amount": 38.50,
      "exchange_rate": 1.0,
      "rate_source": "未折算",
      "rmb_amount": 38.50,
      "deductible": "否",
      "invoice_code": "",
      "invoice_number": "",
      "confidence": "高",
      "notes": ""
    }
  ]
}

说明：
- category 为 null 时脚本按「五」规则自动归类（基于 receipt_type + 摘要关键词）。
- 人民币单据：exchange_rate=1、rate_source="未折算"、rmb_amount=total_amount。
- 外币未折算：currency!=CNY、rmb_amount 留空（null）、exchange_rate 留空。
- 外币折算：rmb_amount = round(total_amount * exchange_rate, 2)，并在 notes/rate_source 注明来源与日期。

十八、免责声明（技能说明中保留）

本技能提供的是票据信息整理与汇总的辅助结果，不构成税务、审计或法律意见；发票真伪、抵扣资格、金额合规性，以及外币折算所用汇率是否满足企业会计政策，均须以税务官方查验平台、中国人民银行公布数据及企业财务制度为准。

附：脚本用法

• 生成默认格式报销单：
  python scripts/reimbursement_builder.py --data 单据数据_202609.json --out ./output
• 套用公司模板：
  python scripts/reimbursement_builder.py --data 单据数据_202609.json --out ./output --template 公司报销模板.xlsx
• 不整理附件（只要表格）：在 JSON meta.build_attachments=false，或不传 --out 时由脚本按 meta 决定。
• 依赖：pip install openpyxl（处理 PDF 文本另需 pdfplumber 或 PyMuPDF）。联网查汇率由 scripts/pbc_rate.py 用 Python 标准库实现，无需额外依赖；若运行环境无法直连央行官网，可由本助手用 WebFetch 读取公告页后把汇率写入 JSON 的 provided_rates，效果等价。
• 单独查询央行中间价（调试/核对用）：python scripts/pbc_rate.py USD 或 python scripts/pbc_rate.py JPY 2026-09-18（支持周末/节假日自动回退到最近公布日）。
• 自检：脚本结束打印 自检通过/失败 与各项明细；失败则不视为交付完成。