发票识别

要解决什么问题

报销、对账、审计时，发票往往只有扫描件或手机照片，人工抄写代码、号码、金额既慢又容易错。不同票种（增值税专用/普通发票、火车票、电子发票等）版式不一，单靠肉眼区分类型再填表，在批量场景下成本很高。

技能如何工作

本技能封装发票识别 OCR 接口，面向「单张图片 → 结构化字段」这一条链路：

• 票种覆盖：支持十几种常见票据；typeid 可设为 auto，由接口自动识别发票类型。
• 输入约束：通过 pic 传入本地图片路径，格式为 JPG/PNG，单张不超过 300KB。
• 执行方式：在技能目录调用查询脚本，携带你在购买页获取的 API Key（也可配置环境变量 CHINAZ_INVOICE_OCR_API_KEY）；脚本把图片与鉴权信息发给上游，将返回 JSON 交给对话侧解读。
• 典型字段：成功时常见字段包括 code（发票代码）、number（发票号码）、date、buyer/seller、totalfee、extaxtotalfee、totaltax、type 等；以 status 判断是否成功，只依据实际返回作答，不编造数据。

缺少 Key 时会得到 missing_api_key，需引导用户到购买页领取 Key 后直接发给 AI（不保存、不回显完整密钥）。

适用边界与注意点

• 范围：仅覆盖「发票识别」接口，不用于其他数据查询或核验类能力（除非返回里另有字段且文档明确）。
• 粒度：一次查询对应单张图片；批量需逐条调用并自行汇总。
• 可靠性：结果来自第三方数据源，可能存在延迟或与官方不一致，仅供参考，重要决策请以官方渠道为准。
• 失败处理：除缺 Key 外，参数错误（invalid_input）、网络/超时等应按返回的 status 与错误信息说明原因，不得虚构查询结果。