生成批量开票文件
将以下提示词粘贴到你的 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 再重跑