Agent Skills
返回列表
生成批量开票文件

生成批量开票文件

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1ba43f2f/batch-invoice。

技能介绍

要解决什么问题

财务或业务同事手头往往是一张「每行一笔明细」的费用表,却要对接电子税务局「数电发票」的批量导入开具——官方模板是固定四张工作表(基本信息、明细、特定业务、附加要素),列名和约束多,手工填极易错行、错税率或漏专票购方税号。

技能如何工作

本技能用 scripts/generate_invoice.py 把用户提供的 Excel/CSV 源表映射到官方空白模板(assets/批量开票模板_空白.xlsx 或 --template 指定文件),输出可直接上传的 xlsx。

核心能力包括:

  • 列名容错:常见别名(购方名称、单号、商品名称等)自动归一到模板字段;表头装饰符号会被忽略。
  • 税率四档判定:优先源表【税率】列,再按【税收编码】、references/tax_codes.csv,再按品名走 item_defaults.csv,最后才接受用户显式指定的 --default-rate;stdout 逐条标明来源,不默认猜 9%。
  • 税收编码匹配:按项目名称精确匹配编码;未命中可告警,由用户补编码或确认默认映射。
  • 购方信息补全:源表缺税号等时从 ~/.workbuddy/invoice-private/buyers.csv(或环境变量路径)带出;专票税号缺失且档案无记录则跳过并报错,不替用户编造。
  • 脏表预处理:--preparse 经 parse_source.py 处理合并单元格、非首行表头、合计行等,再生成。
  • 特定业务校验:货物运输、不动产租赁、建筑服务等需在 sheet3 填法定字段;缺失默认告警,--require-specific 下缺字段则跳过该票。
  • 行政区划校验:起运地、不动产地址等对照 references/admin_divisions.txt 提示标准写法。

Agent 侧约定:正常路径是「源表 + 生成命令」;汇报时只读脚本 stdout,不要用 Read 再打开输出 xlsx 做二次校验。专票缺税号时按 SKILL 流程检索候选统一社会信用代码、经用户确认后写入私有 buyers.csv 再重跑。

边界与注意

  • 仅支持数电发票批量导入,不支持纸质发票流程。
  • 单文件明细超过约 2000 行可能异常、超过 5000 无法开具,需拆分。
  • 客户税号、银行账号等敏感数据应放在技能目录外的私有 CSV,勿写入随包分发的 references/buyers.csv。
  • 不动产地址、产权证号、租赁期等票面要素 Agent 不得猜测,需用户或合同材料补全。

使用场景

  • 月末把多张费用明细 CSV 合并成一张源表,要一次生成可上传的数电批量导入 xlsx
  • 财务导出表带合并单元格和合计行,需先预解析再映射到四张官方工作表
  • 货物运输或不动产租赁类发票,源表要补齐起运地、产权证号等 sheet3 必填项后再导入
  • 固定客户源表只写公司名、缺统一社会信用代码,想用私有客户档案自动带出专票购方税号

适合人员

  • 中小企业财务:每月多笔服务费、运费明细,要按流水号组票并满足专票购方税号校验
  • 开票经办人:熟悉业务表头别名,希望脚本自动对齐税务局模板列名并逐条标注税率推断来源
  • 代理记账或外包开票:维护私有 tax_codes 与客户档案,覆盖内置编码表且升级技能包时不丢数据
  • 使用 Agent 处理开票对话的工程师:需按 stdout 汇报、专票缺税号时走确认后写入 buyers.csv 再重跑