发票 OCR 识别技能

批量识别发票。

⚠️ 首次使用必须配置凭证

此技能需要翔云 OCR 服务，使用前必须先配置凭证！

方式一：向用户提供凭证（推荐）

主动询问用户：

"使用此技能需要翔云 netocr_key 和 netocr_secret，请提供这两个凭证。
获取方式：翔云个人中心"

然后运行：

python scripts/recognize_invoices.py --config

方式二：引导用户自行配置

告诉用户：

"请先运行以下命令配置翔云凭证："

python ~/.openclaw/skills/invoice-ocr/scripts/recognize_invoices.py --config

特点

• ✅ 40+ 发票类型 - 自动识别发票类型
• ✅ 支持 PDF/OFD - 电子发票友好

支持的发票类型

| 票种名称 | 票种代码 | | :------- | :------- | | 增值税专用发票 | 01 | | 机动车销售统一发票 | 03 | | 增值税普通发票 | 04 | | 增值税专用电子发票 | 08 | | 增值税电子普通发票 | 10 | | 增值税普通发票(卷票) | 11 | | 通行费增值税电子普通发票 | 14 | | 二手车销售统一发票 | 15 | | 数电发票(增值税专用发票) | 09 | | 数电发票(普通发票) | 83 | | 数电发票(航空运输电子客票行程单) | 61 | | 数电发票(铁路电子客票) | 62 | | 电子发票(机动车销售统一发票) | 63 | | 数电发票(二手车销售统一发票) | 64 | | 电子发票（普通发票） 通行费 | 72 | | 数电纸质发票(增值税专用发票) | 91 | | 数电纸票发票(普通发票) | 92 | | 数电纸质发票(机动车销售统一发票) | 93 | | 数电纸票发票(二手车销售统一发票) | 94 | | 火车票 | 20 | | 区块链发票 | 21 | | 船票 | 22 | | 定额发票 | 23 | | 机打发票 | 24 | | 出租车发票 | 25 | | 客运汽车 | 26 | | 航空运输电子客票行程单 | 27 | | 过路费 | 28 | | 打车行程单 | 31 | | 货物清单 | 33 | | 财政电子票据 | 34 | | 海关缴款书 | 35 | | 通用电子发票 | 36 | | 完税证明 | 37 | | 医疗票据 | 38 | | 退票费报销凭证 | 39 | | 非税收入一般缴款书(电子) | 40 | | 车辆通行费通用(电子)发票 | 41 | | 银行回单 | 42 |

支持的文件格式

| 格式 | 扩展名 | |------|--------| | PDF | .pdf | | OFD | .ofd | | 图片 | .jpg, .jpeg, .png, .bmp |

使用方法

识别发票

# 识别文件夹中的所有发票
python scripts/recognize_invoices.py /path/to/invoices

# 识别单张发票
python scripts/recognize_invoices.py /path/to/invoices/123.png

配置管理

# 设置翔云凭证
python scripts/recognize_invoices.py --config

# 查看当前配置
python scripts/recognize_invoices.py --list-config

获取 netocr_key 和 netocr_secret

1. 登录翔云
2. 在个人中心获得

详细 API 说明见 翔云 OCR API 参考

工作流程

发票文件 → OCR识别 → 返回结果
   ↓           ↓         ↓
 PDF/图片   混贴识别   JSON结构

注意事项

1. 图片需清晰，建议长宽 > 500px
2. 单个文件不超过 10MB
3. 翔云 OCR 按次计费，注意费用控制
4. 配置文件保存在技能目录下的 config.json