文档首页 > > API参考> API> 增值税发票识别

增值税发票识别

分享
更新时间: 2019/10/30 GMT+08:00

功能介绍

文字识别OCR增值税发票识别识别用户上传的增值税发票图片(或者用户提供的华为云上OBS的增值税发票图片文件的URL)中的文字内容,并将识别的结果返回给用户。

增值税发票仅限于中华人民共和国境内使用的增值税发票

如果图片中包含多张卡证票据,请调用智能分类识别服务。

增值税发票样例如 图1所示。
图1 增值税发票样例

URI

URI格式:

POST /v1.0/ocr/vat-invoice

请求消息

增值税发票识别请求参数请参见表1

表1 请求参数说明

参数

是否必选

参数类型

说明

image

与url二选一

String

图像数据,base64编码,要求base64编码后大小不超过10M。图片最小边不小于100像素,最长边不超过8192像素,支持JPEG/JPG/PNG/BMP/TIFF格式。

url

与image二选一

String

图片的URL路径,目前仅支持华为云上OBS提供的匿名公开授权访问的URL以及公网URL。

响应消息

增值税发票识别响应参数请参见 表2
表2 响应参数说明

参数

参数类型

说明

result

Object

调用成功时表示调用结果。

调用失败时无此字段。

type

String

增值税发票类型,可选值包括:

  • special:增值税专用发票
  • normal:增值税普通发票
  • electronic:增值税电子普通发票

code

String

发票代码。

check_code

String

发票校验码,特定类型增值税发票内不存在该信息时返回空字符串。

number

String

发票号码。

issue_date

String

开票日期。

encryption_block

String

密码区。

buyer_name

String

购买方名称。

buyer_id

String

购买方纳税人识别号。

buyer_address

String

购买方地址、电话。

buyer_bank

String

购买方开户行及帐号。

seller_name

String

销售方名称。

seller_id

String

销售方纳税人识别号。

seller_address

String

销售方地址、电话。

seller_bank

String

销售方开户行及帐号。

subtotal_amount

String

合计金额。

subtotal_tax

String

合计税额。

total

String

价税合计。

item_list

Array of objects

货物或应税劳务列表。

name

String

货物或应税劳务、服务名称。

specification

String

规格型号。

unit

String

单位。

quantity

String

数量。

unit_price

String

单价。

amount

String

金额。

tax_rate

String

税率。

tax

String

税额。

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例(方式一:使用图片的BASE64编码)
    POST https://{endpoint}/v1.0/ocr/vat-invoice 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
     Request Body:
     {   
        "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAj..."
      }
  • 请求示例(方式二:使用图片URL)
    POST https://{endpoint}/v1.0/ocr/vat-invoice 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...     
     Request Body:
     {
         "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName"
      }

Endpoint即调用API的请求地址,不同服务不同区域的Endpoint不同,具体请参见终端节点

例如增值税发票识别服务部署在“华北-北京四”区域的Endpoint为“ocr.cn-north-4.myhuaweicloud.com”,请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/vat-invoice”。

  • 成功响应示例
    {
        "result": {
            "type": "special", 
            "code": "3103162166", 
            "check_code": "", 
            "number": "60543644", 
            "issue_date": "2017年08月30日", 
            "encryption_block": "6/+1+733<672085+063>82>30<1872/1<>*312671<9<1-11208-746599*6/>+7>2163+141-8737*4932+7970*11892126>0*-+7+78>1", 
            "buyer_name": "华为技术有限公司", 
            "buyer_id": "917107277650880665", 
            "buyer_address": "深圳市龙岗区坂田街道华为基地400-830-8300", 
            "buyer_bank": "CDE银行203845432526710", 
            "seller_name": "餐饮有限公司", 
            "seller_id": "9351099411892126", 
            "seller_address": "深圳龙岗区坂田街道0755-82082000", 
            "seller_bank": "ABC银行9911015260873749", 
            "subtotal_amount": "¥8850.00", 
            "subtotal_tax": "¥1504.50", 
            "total": "¥10354.50", 
            "item_list": [
                {
                    "name": "食品A", 
                    "specification": "200g/盒", 
                    "unit": "盒", 
                    "quantity": "300", 
                    "unit_price": "28.00", 
                    "amount": "8400.00", 
                    "tax_rate": "17%", 
                    "tax": "1428.00"
                }, 
                {
                    "name": "食品B", 
                    "specification": "100g/袋", 
                    "unit": "袋", 
                    "quantity": "50", 
                    "unit_price": "9.00", 
                    "amount": "450.00", 
                    "tax_rate": "17%", 
                    "tax": "76.50"
                }
            ]
        }
    }
  • 失败响应示例
    {
        "error_code": "AIS.0103",
        "error_msg": "The image size does not meet the requirements."
    }

状态码

状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区