智能多媒体服务

    • 智能多媒体服务 > 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 是 该参数应严格按照管理凭证格式进行填充，否则会返回 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"
}
    以上内容是否对您有帮助？
    • Qvm free helper
    Close