腾讯云通用票据识别高级版

解决什么问题

在报销、对账、税务归档场景中，增值税发票常以图片、URL 或 PDF 形式存在，人工录入发票代码、税号、金额和明细容易出错。该技能调用腾讯云通用票据识别高级版接口，将发票内容转成结构化 JSON，面向增值税专用发票、增值税普通发票、电子发票和全电发票。

技能如何工作

• 输入方式：支持 ImageBase64 或 ImageUrl，至少提供其一；同时提供时优先 ImageUrl。识别 PDF 需显式设置 IsPdf=true。
• 字段覆盖：识别发票代码、号码、开票日期、校验码、买卖方名称与税号、开户行及账号、金额、税额、价税合计、开票人、复核、备注等。
• 明细结构化：货物/服务名称、规格型号、单位、数量、单价、不含税金额、税率、税额、税收分类编码等进入 VatInvoiceItem，便于入账与核对。
• 全电兼容：内部先分类，全电发票走对应识别链路，再统一映射为 TextVatInvoice 和 VatInvoiceItem 输出。
• 坐标辅助：部分字段返回 Polygon，可用于原图定位和人工复核。

适用边界与注意点

• 文件编码后不超过 10M，像素在 20 到 10000 之间；支持 PNG、JPG、JPEG 和开启后的 PDF，不支持 GIF。
• PdfPageNumber 仅在 IsPdf=true 时有效，默认为第 1 页。
• 默认频率限制为 10 次/秒，批量调用需要节流。
• 服务未开通、欠费、资源包耗尽、图片模糊或解码失败都会返回明确错误码；建议把文件放在腾讯云 COS，降低下载失败概率。