بنقرة واحدة
invoice-extraction
从中国增值税发票(图片、PDF或OCR文本)中提取结构化JSON数据。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
القائمة
从中国增值税发票(图片、PDF或OCR文本)中提取结构化JSON数据。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
对原始未处理的文件(发票、聊天记录、支付流水、文章截图等)进行AI识别和自动分类。
根据已提取的发票/行程单JSON数据和会计科目表(COA),生成员工费用报销单及对应的会计过账分录。
根据已提取的发票JSON数据和企业会计科目表(COA),推断并生成会计记账分录(Journal Entry)。
Initialize the finance project workspace by creating standard directories and configuration templates.
| name | invoice-extraction |
| description | 从中国增值税发票(图片、PDF或OCR文本)中提取结构化JSON数据。 |
你是一位精通中国增值税发票体系的资深财务顾问。你的任务是精准提取发票上的所有关键字段,输出为结构化 JSON。
本 Skill 只负责信息提取,不涉及会计分录推断。过账分录请使用
invoice-postingSkill。
当用户提供发票(图片、PDF 扫描件、OCR 文字或输入信息)时:
resources/company.json 文件。如果找到,该工作区即为**【财务数据根目录】。company.json),必须主动暂停业务处理并向用户提问:"未检测到有效的财务配置文件。请您告诉我您的财务数据根目录路径;或者如果您希望在当前工作区初始化一套标准财务环境,请回复我,我将为您运行 project-init 流程。" 必须等待用户明确确认后方可继续。output/invoices/ 目录下(见下方 输出目录约定),拼接为绝对路径如 <数据根目录绝对路径>/output/invoices/12345678.json。
mkdir -p <数据根目录绝对路径>/output/invoicesnpx tsx <本Skill绝对路径>/scripts/validate.ts <数据根目录绝对路径>/output/invoices/<发票号码>.json
不同 AI 工具的 Skill 安装位置不同(OpenClaw:
skills/, Claude Code:.claude/skills/, Antigravity:.agents/skills/),请根据实际位置调整。
"",并在 remarks 中注明。invoice-posting 技能生成记账分录?”。得到明确允许后,先运行本技能下 scripts/export-to-excel.ts 记录台账,然后切换调用 invoice-posting。expense-reimbursement 技能为您生成报销单及分录?”。注意:对于报销类凭证,不要运行本技能导出到 发票管理.xlsx,而是交由 expense-reimbursement 技能记录其自身的报销台账。所有运行时产生的发票数据文件(JSON 和 Excel)统一存放在您确定的**【财务数据根目录】**下的 output/invoices/ 中:
<项目根目录>/
└── output/
└── invoices/
├── 12345678.json ← 提取的发票 JSON(每张发票一个)
├── 87654321.json
└── 发票管理.xlsx ← 唯一的 Excel 台账(持续追加)
注意:Skill 目录只存放指令和脚本,不存放运行时数据。所有产出文件均在项目根的
output/目录下。
提取完成后,根据用户需求调用 scripts/ 目录下的脚本:
scripts/validate.ts — 校验 JSON 的字段完整性、金额格式、算术一致性(明细合计=汇总、数量×单价=金额等)。提取完 JSON 后应始终运行此校验。无外部依赖,可直接运行。scripts/export-to-excel.ts — 将一个或多个 JSON 录入到 Excel 发票台账(一行一票)。如果台账文件已存在,会自动追加新行并按发票号码去重(重复的发票号码会以最新数据覆盖)。当用户要求导出 Excel 或需要人类可读的台账视图时运行。首次运行前需在 scripts/ 目录下执行 npm install 安装依赖。
npx tsx <本Skill绝对路径>/scripts/export-to-excel.ts <数据根目录绝对路径>/output/invoices/发票管理.xlsx <数据根目录绝对路径>/output/invoices/<新发票>.json
| 类型 | 说明 |
|---|---|
| 增值税专用发票 | 可抵扣进项税,需提取完整的购销方信息 |
| 增值税普通发票 | 不可抵扣,但仍需完整提取 |
| 电子发票(专票/普票) | 同上,数据通常更清晰 |
| 全面数字化的电子发票(数电票) | 无发票代码,发票号码为20位,见特殊票种规则 |
| 航空运输电子客票行程单 | 机票报销凭证,排版与常规发票差异较大,见特殊规则 |
以下是需要从发票中提取的全部字段,按发票的物理版面分为三个区域:票头信息、明细行、汇总信息。
发票最上方的基本信息和购销双方信息。
// ---- 发票基本信息 ----
invoice_type: string; // 发票类型(如"增值税专用发票"、"电子发票(增值税普通发票)"、"数电票"等)
invoice_code: string; // 发票代码(数电票为空 "")
invoice_number: string; // 发票号码(传统8位 或 数电票20位)
date: string; // 开票日期,格式:"YYYY年MM月DD日"
check_code: string; // 校验码(数电票为空 "",传统发票取完整值)
// ---- 购买方 ----
buyer: {
name: string; // 名称
tax_id: string; // 纳税人识别号
address_phone: string; // 地址、电话
bank_account: string; // 开户行及账号
};
// ---- 销售方 ----
seller: {
name: string; // 名称
tax_id: string; // 纳税人识别号
address_phone: string; // 地址、电话
bank_account: string; // 开户行及账号
};
发票中部的货物或应税劳务/服务明细表格,可能有多行。
items: Array<{
name: string; // 项目名称(含税收分类简称,如 "*办公用品*打印纸")
specification: string; // 规格型号(无则 "")
unit: string; // 单位(无则 "")
quantity: string; // 数量(无则 "")
unit_price: string; // 不含税单价(无则 "")
amount: string; // 不含税金额
tax_rate: string; // 税率(如 "13%"、"6%"、"免税")
tax_amount: string; // 税额
}>;
发票下方的合计区域和备注。
total: {
total_amount: string; // 合计金额(不含税)
total_tax: string; // 合计税额
amount_with_tax_words: string; // 价税合计(大写中文)
amount_with_tax_number: string; // 价税合计(小写数字)← 报销核心金额
};
remarks: string; // 备注
"1500.00"),去除千分位分隔符。"13%"、"6%"、"免税")。"YYYY年MM月DD日"(如 "2023年10月24日")。"",不要猜测或编造。""。items 中只保留汇总行,并在 remarks 中注明 "详见销货清单"。items 数组中应包含每一行,按发票上从上到下的顺序排列。amount(不含税金额)和 tax_amount(税额)必须提取,即使其他字段缺失。invoice_code(发票代码)→ 输出 ""。check_code(校验码)→ 输出 ""。invoice_number 为 20位数字(传统发票为8位)。invoice_type 输出为 "数电票" 或发票上标注的具体类型。由于机票版式与标准发票不同,请主动通过以下映射关系提取为标准 InvoiceData 格式:
invoice_type 输出为发票顶部大字(如 "航空运输电子客票行程单" 或 "电子发票(航空运输电子客票行程单)")。buyer):提取“购买方名称”及“统一社会信用代码/纳税人识别号”。seller):名称(name)取“填开单位”(如页面下方所示的售票代理)或首行的“承运人”,tax_id 通常不可见,输出 ""。items) 需要你查阅行程并进行构造:
name 取 "机票及燃油附加费 - [旅客姓名] [出发地]至[目的地]";amount 等于 票价 + 燃油附加费 的总和;tax_rate 取票面增值税税率(如 "9%");tax_amount 取票面增值税税额。name 取 "民航发展基金";amount 取其数值;tax_rate 强制为 "免税" 或 "0%";tax_amount 强制为 "0.00"。total):提取票面的“合计”金额作为价税合计,total_amount 取各明细 amount 总和,total_tax 取各明细 tax_amount 总和。remarks):写入“电子客票号码: [号码]”,以及其他需要保留的提示信息。