OCR文字识别
本页目录
增值税发票（兼容电子发票）V2识别
更新时间：2026-05-12 15:51:52
1.报文协议
HTTP(S) + JSON
2.接口地址
测试环境：https://test-api-open.chinaums.com/v1/brain/ocr/vatinvoice
生产环境：https://api-lob.open.chinaums.com/v1/brain/ocr/vatinvoice
3.报文格式
3.1 请求HTTP报文头：
| 参数名称 | 参数说明 | 参数类型 | 是否必须 | 备注 |
|---|---|---|---|---|
| Authorization | 认证内容 | 字符串 | 是 | 请见认证流程章节 |
URL参数：无
POST参数：
格式：JSON
| 参数名称 | 参数说明 | 参数类型 | 长度 | 是否必须 | 备注 |
|---|---|---|---|---|---|
| data | 固定字段，其他入参可放入里面 | object | 是 | ||
| requestID | 唯一请求识别码 | 字符串 | 否 | 与唯一响应识别码一致 | |
| picBase64 | 图片文件 | 字符串 | 是 | 图片文件的BASE64编码 |
3.2 响应
格式：JSON
| 序号 | 域名描述 | 域名 | 数值类型 | 最大长度 | 是否必选 | 备注 |
|---|---|---|---|---|---|---|
| 1 | 银商大脑层错误码 | errCode | string | 8 | 是 | |
| 2 | 银商大脑层错误信息 | errMsg | string | 是 | ||
| 3 | OCR层错误码 | code | string | 8 | 是 | |
| 4 | OCR层错误信息 | msg | string | 256 | 是 | |
| 5 | 识别结果 | ocrResult | dict | 是 | 各个字段识别结果 | |
| 6 | 唯一响应识别码 | responseID | String | 5M | 是 | 与唯一请求识别码保持一致 |
ocrResult中的各个字段说明如下：
| 序号 | 域名描述 | 域名 | 数值类型 | 最大长度 | 是否必选 | 备注 |
|---|---|---|---|---|---|---|
| 1 | 发票名称 | invoiceName | string | 24 | 是 | |
| 2 | 发票代码 | invoiceCode | string | 24 | 否 | |
| 3 | 发票号码 | invoiceNumber | string | 24 | 是 | |
| 4 | 开票日期 | invoiceDate | string | 12 | 是 | |
| 5 | 校验码 | checkCode | string | 16 | 否 | |
| 6 | 机器编号 | machineNo | string | 24 | 否 | |
| 7 | 购买方名称 | buyerName | string | 64 | 是 | |
| 8 | 购买方纳税人识别号/统一社会信用代码 | buyerNumber | string | 64 | 是 | |
| 9 | 购买方地址、电话 | buyerAddressAndPhone | string | 64 | 否 | |
| 10 | 购买方开户行及账号 | buyerBankAndAccount | string | 64 | 否 | |
| 11 | 密码区 | passwordArea | string | 256 | 否 | |
| 12 | 销售方名称 | sellerName | string | 64 | 是 | |
| 13 | 销售方纳税人识别号/统一社会信用代码 | sellerNumber | string | 64 | 是 | |
| 14 | 销售方地址、电话 | sellerAddressAndPhone | string | 64 | 否 | |
| 15 | 销售方开户行及账号 | sellerBankAndAccount | string | 64 | 否 | |
| 16 | 项目名称/货物或应税劳动、服务名称 | projectName | List |
是 | ||
| 17 | 规格型号 | specModel | List |
是 | ||
| 18 | 单位 | unit | List |
是 | ||
| 19 | 数量 | quantity | List |
是 | ||
| 20 | 单价 | unitPrice | List |
是 | ||
| 21 | 金额 | amount | List |
是 | ||
| 22 | 税率/征收率 | taxRate | List |
是 | ||
| 23 | 税额 | taxAmount | List |
是 | ||
| 24 | 合计金额 | totalAmount | string | 16 | 是 | |
| 25 | 合计税额 | totalTaxAmount | string | 16 | 是 | |
| 26 | 价税合计大写 | capitalPriceAndTax | string | 24 | 是 | |
| 27 | 价税合计小写 | lowerPriceAndTax | string | 16 | 是 | |
| 28 | 备注 | notes | string | 256 | 否 | |
| 29 | 收款人 | recipient | string | 16 | 否 | |
| 30 | 复核 | reviewer | string | 16 | 否 | |
| 31 | 开票人 | drawer | string | 16 | 是 | |
| 32 | 机打号码 | machineNumber | string | 24 | 否 | |
| 33 | 二维码 | QRCode | List |
否 |
注：二维码中的第2个数字表示发票类型，含义如下：
增值税专用发票：01
增值税普通发票：04
增值税电子普通发票：10
增值税电子专用发票： 20
增值税普通发票（卷式）：11
增值税普通发票（通行费）：14
电子发票（增值税专用发票）：31
电子发票（增值税普通发票）：32
< 上一篇：增值税发票识别
意见反馈
感谢您反馈问题或意见
类型
- 卡顿
- 登录或账号问题
- 功能使用异常
- 意见或建议
- 其他
描述
点击上传图片；单张图片应小于1M。
0/200