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

增值税发票识别

分享
更新时间: 2019/06/18 18:55
说明:

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

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

URI

URI格式

POST /v1.0/ocr/vat-invoice

请求消息

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

表1 请求参数说明

名称

是否必选

类型

说明

image

与url二选一

String

图像数据,base64编码,要求base64编码后大小不超过10M。图像各边的像素大小在100到8192px之间,支持JPG/PNG/BMP/TIFF格式。

url

与image二选一

String

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

响应消息

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

名称

类型

说明

result

JSON

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

调用失败时无此字段。

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

List

货物或应税劳务列表。

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://ocr.cn-north-1.myhuaweicloud.com/v1.0/ocr/vat-invoice 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
        
     Request Body:
     {   
    "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..."
      }
  • 请求示例(方式二:使用图片URL)
    POST https://ocr.cn-north-1.myhuaweicloud.com/v1.0/ocr/vat-invoice 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
        
     Request Body:
     {
         "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName"
      }
  • 成功响应示例
    {
        "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.0105",
        "error_msg": "Recognize Failed"
    }

返回值

  • 正常

    200

  • 失败

    返回值

    说明

    400

    • 语义有误,当前请求无法被服务器解析。除非进行修改,否则客户端不应重复提交这个请求。
    • 请求参数有误。

    401

    当前请求需要用户验证。

    403

    没有操作权限。

    404

    请求失败,在服务器上未找到请求所希望得到的资源。

    500

    服务器遇到了一个未曾预料的状况,导致无法完成对请求的处理。

如果您喜欢这篇文档,您还可以:

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区