增值税发票识别

API

增值税发票 OCR 识别，支持增值税专用发票、普通发票、电子普票，输出 22+ 个结构化字段。 • 双输入模式： - input type=url：传入公网可访问的图片 URL（http/https） - input type=base64：传入 base64 编码字符串（≤6M…

文档

由极数本源提供·更新于昨天

累计调用

1099ms

平均响应

100.00%

服务可用性

300 次/日

免费额度

访问限制

查看更多方案 →

我的方案免费方案升级套餐

QPS 2

今日已用 0 / 300 次/日0.0%

登录并携带 API Key 可使用上方免费额度；会员额度见下方各档

无 Key 调用

每日 50 次 · QPS 1

登录免费

当前方案

每日 300 次 · QPS 2

黄金会员

每日 50,000 次 · QPS 60

企业会员

每日 1,000,000 次 · QPS 120

文档链接

复制文档地址

https://apizero.cn/aidocs/invoice/raw.md

接口请求地址

https://v1.apizero.cn/api/invoice

接口请求方式

POST

请求参数格式

APPLICATION/JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/invoice

接口信息备注

匿名每日 5 次、QPS 1；登录用户每日 30 次、QPS 2（全部免费）。OCR 结果缓存 1 小时，相同图片只实际调用服务一次。

请求参数说明

名称	类型	说明
input_type	string	必填 · 输入类型：url=图片URL / base64=图片base64编码 · 示例：url
input_data	string	必填 · 发票图片数据。input_type=url 时为 http/https 完整 URL；input_type=base64 时为 base64 字符串（最大 6MB，可选 data:image/jpeg;base64, 前缀） · 示例：https://example.com/invoice.jpg

请求头说明

名称	类型	说明
Authorization	string	可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。
Content-Type	string	必填 · POST 请求体类型，固定 application/x-www-form-urlencoded；如使用 base64 模式建议 POST

返回字段说明

名称	类型	说明
invoice_name	string	发票名称（如「增值税电子普通发票」）
invoice_code	string	发票代码（10-12 位数字）
invoice_no	string	发票号码（8-20 位数字）
invoice_date	string	开票日期，格式 YYYY-MM-DD 或 YYYY年MM月DD日
check_code	string	校验码（20 位数字，部分电子发票无）
machine_num	string	机器编号（12 位）
total_price	string	不含税金额（保留为字符串避免浮点精度问题）
total_tax	string	税额合计
total_price_and_tax	string	价税合计（小写）
big_total_price_and_tax	string	价税合计（大写中文，如「壹佰元整」）
buyer	object	购方信息对象
buyer.name	string	购方名称
buyer.taxpayer_no	string	购方纳税人识别号
buyer.address_phone	string	购方地址电话
buyer.account	string	购方开户行及账号
seller	object	销方信息对象（结构同 buyer）
payee	string	收款人
reviewer	string	复核人
drawer	string	开票人
remarks	string	备注（含税控盘信息、说明等）
items	array	商品明细数组，每项含名称/规格/数量/单价/金额/税率/税额等字段（具体字段以服务识别结果为准）
tips	string	品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "invoice_name": "增值税电子普通发票",
    "invoice_code": "011002000311",
    "invoice_no": "12345678",
    "invoice_date": "2024-08-15",
    "check_code": "12345 67890 12345 67890",
    "machine_num": "499099111111",
    "total_price": "94.34",
    "total_tax": "5.66",
    "total_price_and_tax": "100.00",
    "big_total_price_and_tax": "壹佰圆整",
    "buyer": {
      "name": "某某科技有限公司",
      "taxpayer_no": "91110000XXXXXXXXXX",
      "address_phone": "北京市XX区XX路XX号 010-12345678",
      "account": "中国银行 6217001234567890"
    },
    "seller": {
      "name": "某某商贸有限公司",
      "taxpayer_no": "91310000YYYYYYYYYY",
      "address_phone": "上海市XX区XX路XX号 021-87654321",
      "account": "工商银行 6222001234567890"
    },
    "payee": "张三",
    "reviewer": "李四",
    "drawer": "王五",
    "remarks": "",
    "items": [
      {
        "name": "*技术服务*软件开发服务",
        "specification": "",
        "unit": "",
        "quantity": "",
        "unit_price": "",
        "amount": "94.34",
        "tax_rate": "6%",
        "tax": "5.66"
      }
    ]
  },
  "request_id": "abc123def456",
  "tips": "极数本源 · https://apizero.cn"
}

免责声明

本接口第三方 OCR 服务，识别准确率取决于图片清晰度（建议 ≥1080P 分辨率）。OCR 服务为付费配额接口，请合理使用，避免恶意刷量。识别失败原因可能包括：图片模糊、非发票类型、URL 不可达、base64 数据损坏等。

加载接口文档…

名称

类型

说明

input_type

string

必填 · 输入类型：url=图片URL / base64=图片base64编码 · 示例：url

input_data

string

必填 · 发票图片数据。input_type=url 时为 http/https 完整 URL；input_type=base64 时为 base64 字符串（最大 6MB，可选 data:image/jpeg;base64, 前缀） · 示例：https://example.com/invoice.jpg

名称

类型

说明

Authorization

string

可选 · 推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。匿名可不传，受每日免费额度限制。

Content-Type

string

必填 · POST 请求体类型，固定 application/x-www-form-urlencoded；如使用 base64 模式建议 POST

名称

类型

说明

invoice_name

string

发票名称（如「增值税电子普通发票」）

invoice_code

string

发票代码（10-12 位数字）

invoice_no

string

发票号码（8-20 位数字）

invoice_date

string

开票日期，格式 YYYY-MM-DD 或 YYYY年MM月DD日

check_code

string

校验码（20 位数字，部分电子发票无）

machine_num

string

机器编号（12 位）

total_price

string

不含税金额（保留为字符串避免浮点精度问题）

total_tax

string

税额合计

total_price_and_tax

string

价税合计（小写）

big_total_price_and_tax

string

价税合计（大写中文，如「壹佰元整」）

buyer

object

购方信息对象

buyer.name

string

购方名称

buyer.taxpayer_no

string

购方纳税人识别号

buyer.address_phone

string

购方地址电话

buyer.account

string

购方开户行及账号

seller

object

销方信息对象（结构同 buyer）

payee

string

收款人

reviewer

string

复核人

drawer

string

开票人

remarks

string

备注（含税控盘信息、说明等）

items

array

商品明细数组，每项含名称/规格/数量/单价/金额/税率/税额等字段（具体字段以服务识别结果为准）

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{ "code": 0, "msg": "成功", "data": { "invoice_name": "增值税电子普通发票", "invoice_code": "011002000311", "invoice_no": "12345678", "invoice_date": "2024-08-15", "check_code": "12345 67890 12345 67890", "machine_num": "499099111111", "total_price": "94.34", "total_tax": "5.66", "total_price_and_tax": "100.00", "big_total_price_and_tax": "壹佰圆整", "buyer": { "name": "某某科技有限公司", "taxpayer_no": "91110000XXXXXXXXXX", "address_phone": "北京市XX区XX路XX号 010-12345678", "account": "中国银行 6217001234567890" }, "seller": { "name": "某某商贸有限公司", "taxpayer_no": "91310000YYYYYYYYYY", "address_phone": "上海市XX区XX路XX号 021-87654321", "account": "工商银行 6222001234567890" }, "payee": "张三", "reviewer": "李四", "drawer": "王五", "remarks": "", "items": [ { "name": "*技术服务*软件开发服务", "specification": "", "unit": "", "quantity": "", "unit_price": "", "amount": "94.34", "tax_rate": "6%", "tax": "5.66" } ] }, "request_id": "abc123def456", "tips": "极数本源 · https://apizero.cn" }