通用发票OCR识别

接口标识: invoiceocr 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

通用发票OCR识别接口支持发票图片与 PDF 文件（PDF 识别首页内容），覆盖增值税普票、专票、电子票与全电发票等常见票种，一次返回 28 个字段：发票代码、号码、开票日期与校验码；不含税金额、税额及大小写价税合计；购销双方的名称、纳税人识别号、地址电话与开户账号；还有收款人、复核人、开票人、备注、是否代开，以及按行列出的商品名称、金额、税率与税额明细，适合报销审核、财务录入与票据归档等场景。

详细介绍

![通用发票OCR识别接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_invoiceocr__1794169371_d07096972393.png)

财务报销要逐张核对发票，还在手工录入发票代码、号码和金额？上传一张发票图片或一份 PDF，票面要素一次读全，自动落成结构化字段，直接进你的报销与记账系统。

## 接口概述

通用发票OCR识别接口面向企业报销、财务共享中心、税务合规、供应链对账等票据收取场景：传入一张发票图片（JPG/PNG 等）或一份发票 PDF（公网URL、Base64 或平台文件ID），由阿里云百炼视觉大模型（默认 qwen3.5-ocr，平台可在后台切换）完成整票读取，同步返回发票种类、发票代码、发票号码、开票日期、合计金额、合计税额、价税合计大小写、校验码、购销双方名称/税号/地址电话/开户行账号、收款人、复核人、开票人、备注、省市与代开标识、商品明细四数组共 28 个字段。PDF 输入由平台自动转为首页图片后识别（多页 PDF 仅识别第一页）。响应按固定字段清单构造：未识别到的字段统一返回空字符串，商品明细类字段返回空数组，不会出现 null、不会缺键。

## 核心能力

1. **整票要素一次读全**：发票基本信息、金额税额、购销双方、票面人员、商品明细共 28 个字段，免去逐张手工录入。
2. **图片与 PDF 双支持**：本批 OCR 接口中唯一支持 PDF 输入，电子发票 PDF 无需先自行转图；多页 PDF 仅识别第一页。
3. **固定字段契约**：响应始终返回全部 28 个字段，未识别到的为空字符串，商品明细为空数组，解析与入库无需防御性判断。
4. **商品明细按行对齐**：货物名称、金额、税率、税额为四个字符串数组，按下标一一对应，多行商品逐行展开。
5. **备注信息自动补全**：收款人、复核人、购销双方开户行账号在票面主体缺失时，自动从备注区二次提取补全。

## 产品优势

- **接入简单**：仅 `file` 一个业务参数，POST 请求即返 JSON，无需自建识别引擎与维护票种模板。
- **稳定可靠**：响应字段与文档约定一致，识别不到时返回空字符串或空数组而非报错，集成侧逻辑简单。

## 效果展示

一句话理解：它就像一位细致的票据审核员，把整张发票「念」成一张标准表格——代码、号码、金额、购销双方、每行商品，一个字段都不落。

以一次典型调用为例（上传电子发票 PDF），你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/invoice.pdf | 发票文件的公网URL，支持图片或 PDF，也支持 Base64（data:开头）或文件ID（fileid_开头） |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 发票种类 | 增值税电子普通发票 | `invoiceType` |
| 发票代码 | `"3100153130"` | `invoiceCode`，字符串形态 |
| 发票号码 | `"12345678"` | `invoiceNum`，字符串形态 |
| 开票日期 | 2026年03月15日 | `invoiceDate`，按票面原文返回，不做格式归一 |
| 价税合计（小写） | `"1060.00"` | `amountInFiguers`，与合计金额、税额自洽 |
| 购买方名称 | 杭州云帆网络科技有限公司 | `purchaserName` |
| 销售方名称 | 深圳市创联信息技术有限公司 | `sellerName` |
| 货物名称 | 技术服务费 | `commodityName`，字符串数组，与金额、税率、税额按下标对应 |

API请求示例：

```
POST /api/v1/invoiceocr
file=https://example.com/demo/invoice.pdf
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "invoiceType": "增值税电子普通发票",
    "invoiceCode": "3100153130",
    "invoiceNum": "12345678",
    "invoiceDate": "2026年03月15日",
    "totalAmount": "1000.00",
    "totalTax": "60.00",
    "amountInFiguers": "1060.00",
    "amountInWords": "壹仟零陆拾圆整",
    "checkCode": "",
    "purchaserName": "杭州云帆网络科技有限公司",
    "purchaserRegisterNum": "91330100MA2ABCDE7X",
    "purchaserAddress": "浙江省杭州市滨江区网商路599号",
    "purchaserBank": "中国建设银行杭州滨江支行;账号:33001234567890123456",
    "sellerName": "深圳市创联信息技术有限公司",
    "sellerRegisterNum": "91440300MA5EX2345B",
    "sellerAddress": "广东省深圳市南山区科技园南区8栋301",
    "sellerBank": "招商银行深圳科技园支行;账号:755912345678901",
    "payee": "刘芳",
    "checker": "王强",
    "noteDrawer": "陈静",
    "remarks": "",
    "province": "",
    "city": "",
    "agent": "",
    "commodityName": ["技术服务费"],
    "commodityAmount": ["1000.00"],
    "commodityTaxRate": ["6%"],
    "commodityTax": ["60.00"]
  }
}
```

一次调用即完成整票读取：示例中金额自洽（1000.00 + 60.00 = 1060.00）；`checkCode`、`remarks`、`province` 等票面缺失或模型未输出的字段以空字符串返回，商品明细以数组返回，入库前无需做类型转换。

## 应用场景

- **员工报销审核**：自动提取价税合计与开票日期，与报销单金额交叉核验，异常票转人工。
- **财务共享中心**：批量票据识别入账，发票代码与号码自动查重，防止重复报销。
- **税务合规检查**：购销双方税号与商品税率结构化留档，便于进项税管理。
- **供应链对账**：读取销售方与商品明细，与采购订单逐行比对。
- **票据档案数字化**：纸质发票与电子 PDF 统一转结构化数据，按票种、日期归档检索。

## 应用案例

- **集团财务共享中心**：原先会计逐张录入发票要素，一张要几分钟还偶有错录；接入后图片与电子 PDF 统一走接口识别，代码、号码、金额自动入账并查重，单票处理耗时大幅压缩，重复报销在提交环节即被拦截。
- **企业费控系统**：员工拍照或转发电子发票 PDF 提交报销，系统自动带出票面要素并与申请金额核验，价税不一致或临期发票当场提示，财务退单率明显下降。
- **物流供应链平台**：运费发票按行识别商品明细数组，与运单费用逐项对账，月末对账周期从数天缩短到当天完成。

常见问题

Q：通用发票OCR识别接口支持哪些发票？

A：覆盖增值税普通发票、专用发票、电子发票、卷票等常见票种，按票面实际内容提取。返回发票种类、代码、号码、开票日期、金额税额、购销双方信息、票面人员、备注与商品明细共28个字段。同步接口，调用后直接返回结果。

Q：支持什么格式的文件输入？

A：file 参数可传公网URL、data: 开头的 Base64 字符串或 fileid_ 开头的文件ID。文件类型支持常见图片（JPG、PNG、BMP、WEBP 等）与 PDF；PDF 由平台自动转为首页图片后识别，多页 PDF 仅识别第一页，Word、Excel 等办公文档不支持。

Q：识别不到的字段会怎样？

A：响应按固定字段清单构造，28个字段始终全部返回：普通字段未识别为空字符串，商品明细四字段为空数组，不会出现 null。识别由大模型完成，无法承诺百分之百准确，建议对发票代码、号码、价税合计等关键字段做非空校验并辅以人工复核。

Q：金额和开票日期是什么格式？

A：金额类字段按票面识别结果返回，通常为字符串形态（如 "1060.00"），接口不做数值类型转换，解析时建议兼容字符串与数值两种形态。invoiceDate 不做日期格式归一，通常为票面原文写法（如「2026年03月15日」），请按实际返回处理。

Q：商品明细字段怎么用？

A：commodityName、commodityAmount、commodityTaxRate、commodityTax 为四个字符串数组，按下标一一对应：第 i 行商品的名称、金额、税率、税额分别取四个数组的第 i 个元素。单行商品的发票数组长度为 1。

发票识别增值税发票票据OCR 财务报销电子发票PDF 票据归档

接口地址： https://www.phpwc.cn/api/invoiceocr

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`invoiceType`	string	发票种类（电子普通发票/专用发票/全电发票等）
`invoiceCode`	string	发票代码
`invoiceNum`	string	发票号码
`invoiceDate`	string	开票日期
`totalAmount`	string	合计金额（不含税）
`totalTax`	string	合计税额
`amountInFiguers`	string	价税合计（小写）
`amountInWords`	string	价税合计（大写）
`checkCode`	string	校验码
`purchaserName`	string	购买方名称
`purchaserRegisterNum`	string	购买方纳税人识别号
`purchaserAddress`	string	购买方地址及电话
`purchaserBank`	string	购买方开户行及账号
`sellerName`	string	销售方名称
`sellerRegisterNum`	string	销售方纳税人识别号
`sellerAddress`	string	销售方地址及电话
`sellerBank`	string	销售方开户行及账号
`payee`	string	收款人
`checker`	string	复核人
`noteDrawer`	string	开票人
`remarks`	string	备注
`province`	string	省份
`city`	string	城市
`agent`	string	是否代开
`commodityName`	array	货物名称（[{row, word}]）
`commodityAmount`	array	金额（[{row, word}]）
`commodityTaxRate`	array	税率（[{row, word}]）
`commodityTax`	array	税额（[{row, word}]）
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试