human: 如何处理七牛云的智能多媒体服务增值税发票 OCR

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > 票证自动识别（OCR） >增值税发票 OCR

#  增值税发票 OCR

最近更新时间: 2023-06-01 17:02:17

# 接口说明

增值税发票文字识别，结构化输出增值税发票上的字段文字信息。

## 限制条件

  1. 文件格式：支持JPG、JPEG、PNG、BMP、PDF、OFD等常见格式，建议使用JPG格式。
  2. 图片像素尺寸：最小 256 x 256 像素，最大 2048 x 2048 像素。为了保证文字识别效果，推荐图片中增值税发票最短边长不低于256像素。
  3. 文件大小：  
a.要求Base64编码和urlencode之后不超过 8 MB。增值税发票主体尽量占据图片主要区域，不支持黑白图片。  
b.如果传图片及PDF完整URL，URL对应文件大小建议不要超过8MB。

  4. 输入文件过大时，返回的HttpCode如下：400/413/502。
  5. 注意图片质量：保证增值税发票图片足够清晰，不应该有因为压缩导致的噪声，避免对增值税发票正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。
  6. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。
  7. 增值税发票图片不可以是复印件、翻拍件、PS件等。
  8. 输入多页PDF时，默认只识别第一页。

# 请求

## 请求地址

名称 | 值  
---|---  
HTTP URL | https://ap-gate-z0.qiniuapi.com/ocr/vat/invoice  
HTTP Method | POST  
  
## 请求头

名称 | 必填 | 说明  
---|---|---  
Host | 是 | 固定值ap-gate-z0.qiniuapi.com  
Authorization | 是 | 该参数应严格按照[管理凭证格式 __](https://developer.qiniu.io/kodo/1201/access-token)进行填充，否则会返回 401 错误码。一个合法的 Authorization 值应类似于：Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7…  
Content-Type | 是 | 固定值application/json  
  
## 请求参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
image_base64 | 否 | string | 驾驶证图片文件，base64编码  
image_url | 否 | string | 图片/PDF文件的URL链接  
注意: 要求image_base64与image_url二选一，如果2个字段都有，优先解析image_base64。  
  
## 请求示例

    
    
    POST /ocr/vat/invoice
    Host: ap-gate-z0.qiniuapi.com
    Authorization: <no value>
    Content-Type: application/json
    
    {
      "image_base64": "base64"
    }
    

# 响应

## 响应头

名称 | 必填 | 说明  
---|---|---  
Content-Type | 是 | 固定值application/json  
  
## 响应参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
message | 是 | string | 错误信息  
request_id | 是 | string | 请求唯一ID  
time_elapsed | 是 | string | 请求耗时  
code | 是 | number | 错误码  
data | 否 | object data |   
  
其中， _data_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
license_main | 否 | object license_main |   
  
其中， _license_main_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
payee | 否 | string | 收款人  
seller_taxpayer_no_in_seal | 否 | string | 盖章公司纳税人识别号  
check_code | 否 | string | 校验码  
total_tax | 否 | string | 税额  
invoice_code | 否 | string | 发票代码  
invoice_name | 否 | string | 发票名称  
sheet_name | 否 | string | 发票联次  
big_total_price_and_tax | 否 | string | 大写金额（价税合计）  
drawer | 否 | string | 开票人  
is_secret_out_bound | 否 | string | 密码区是否出界  
seller_account | 否 | string | 销售方开户行&账号  
seller_address_phone | 否 | string | 销售方地址&电话  
seller_name | 否 | string | 销售方  
seller_name_in_seal | 否 | string | 盖章公司名称  
total_price | 否 | string | 金额  
buyer_taxpayer_no | 否 | string | 购买方纳税人识别号  
entry | 否 | []object entry | 相片位置  
typed_invoice_no | 否 | string | 机打发票号码  
buyer_account | 否 | string | 购买方开户行&账号  
machine_num | 否 | string | 机器编号  
total_price_and_tax | 否 | string | 小写金额（价税合计）  
invoice_no | 否 | string | 发票号码  
invoice_special_seal | 否 | string | 发票专用章  
is_sealed | 否 | string | 是否加盖章  
reviewer | 否 | string | 复核  
seller_taxpayer_no | 否 | string | 销售方识别号  
sub_type | 否 | string | 增值税发票类别  
buyer_address_phone | 否 | string | 购买方地址&电话  
invoice_date | 否 | string | 开票日期  
typed_invoice_code | 否 | string | 机打发票代码  
beizhu | 否 | string | 备注  
buyer_name | 否 | string | 购买方名称  
  
其中， _entry_ 参数

字段 | 必填 | 类型 | 说明  
---|---|---|---  
quantity | 否 | string | 数量  
tax_amount | 否 | string | 税额  
tax_rate | 否 | string | 税率  
uint | 否 | string | 单位  
unit_price | 否 | string | 单价(不含税)  
xinghao | 否 | string | 型号  
entry_name | 否 | string | 货物或应税劳务、服务名称  
price_amount | 否 | string | 金额  
  
_sub_type_ 发票类别字段说明

字段 | 类型 | 说明  
---|---|---  
ele_vat | string | 增值税电子普通发票  
ele_special_vat | string | 增值税电子专票  
print_vat | string | 增值税纸质普票  
special_vat | string | 增值税纸质专票  
other_vat | string | 其他电子发票  
quandian_special_vat | string | 全电专票  
quandian_vat | string | 全电普票  
unknown_vat | string | 未知票  
  
## 响应示例

    
    
    200 OK
    Content-Type: application/json
    
    {
      "code": 10000,
      "data": {
        "license_main": {
          "big_total_price_and_tax": "柒拾叁圆玖角贰分",
          "buyer_name": "北京字跳网络技术有限公司",
          "buyer_taxpayer_no": "91110108MA01F2L25J",
          "check_code": "16649652847559064366",
          "drawer": "杜洪亮",
          "entry": [
            {
              "entry_name": "*运输服务*客运服务费",
              "price_amount": "73.92",
              "quantity": "1",
              "tax_amount": "***",
              "tax_rate": "免税",
              "unit": "次",
              "unit_prict": "73.92",
              "xinghao": "无"
            }
          ],
          "invoice_code": "011002000611",
          "invoice_date": "2020年12月14日",
          "invoice_name": "XX增值税电子普通发票",
          "invoice_no": "10178760",
          "invoice_special_seal": "发票专用章",
          "is_sealed": "true",
          "machine_num": "499098491560",
          "payee": "张雪丽",
          "reviewer": "蔡静",
          "seller_account": "招商银行股份有限公司北京东三环支行110936504210806",
          "seller_address_phone": "北京市海淀区东北旺西路8号院34号楼二层208号010-62682929",
          "seller_name": "北京滴滴出行科技有限公司",
          "seller_name_in_seal": "北京滴滴出行科技有限公司",
          "seller_taxpayer_no": "91110108MA01G0FB09",
          "seller_taxpayer_no_in_seal": "91110108MA01G0FB09",
          "sub_type": "ele_vat",
          "total_price": "73.92",
          "total_price_and_tax": "73.92",
          "total_tax": "***"
        }
      },
      "message": "Success",
      "request_id": "6838889517957515275",
      "time_elapsed": "41.897331ms"
    }
    

以上内容是否对您有帮助？