1. 接口说明

讯飞开放平台通过 REST API 的方式给开发者提供图像识别的 HTTP接口，基于本接口开发者可以识别并提取增值税发票（中文简体）中的信息，方便开发者使用自己熟悉的编程语言快速集成。

2. 接口地址

  1. POST http[s]://webapi.xfyun.cn/v1/service/v1/ocr/invoice

3. 请求参数

在 Http Request Header 中配置授权认证参数，见【接口描述-授权认证】。其中 X-Param 为各配置参数组成的JSON串经BASE64编码之后的字符串，原始JSON串各字段说明如下：

参数类型必填说明示例
engine_typestring否识别类型invoice

X-Param生成示例：

  1. 原始JSON串：
  2. {
  3.    "engine_type":"invoice"
  4. }
  5. BASE64编码（即X-Param）：
  6. ewoJICAgICJsYW5ndWFnZSI6ICJlbiIsCgkgICAgInBvc2l0aW9uIjogImZhbHNlIgoJfQ==

在Http Request Body配置以下参数：

参数类型必须说明示例
imagestring是图像数据，base64编码后进行urlencode，要求base64编码和urlencode后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式exSI6ICJlbiIsCgkgICAgInBvc2l0aW9uIjogImZhbHNlIgoJf…

4. 返回值

返回值为json串，各字段如下：

参数类型说明
codestring结果码(具体见错误码)
datajson详见data说明
descstring描述
sidstring会话ID

其中sid字段主要用于DEBUG追查问题，如果出现问题，可以提供sid给讯飞技术人员帮助确认问题。

data各字段说明如下：

参数类型说明
blockjson数组区域块
vat_invoice_correct_code校验码增值税发票上的校验码识别结果。
vat_invoice_daima发票代码增值税发票上的发票代码识别结果。
vat_invoice_haoma发票号码增值税发票上的发票号码识别结果。
vat_invoice_issue_date开票日期增值税发票上的开票日期识别结果。
vat_invoice_rate_payer_id纳税人识别号增值税发票上的纳税人识别号识别结果。
vat_invoice_total合计增值税发票上的合计识别结果。
vat_invoice_tax_rate税率增值税发票上的税率识别结果。
vat_invoice_jida_haoma机打号码增值税发票上的机打号码识别结果。
vat_invoice_seller_name销售方名称增值税发票上的销售方名称识别结果。
vat_invoice_seller_bank_account销售方开户行及帐号增值税发票上的销售方开户行及帐号识别结果。
vat_invoice_seller_id销售方纳税人识别号增值税发票上的销售方纳税人识别号识别结果。
vat_invoice_seller_addr_tell销售方地址电话增值税发票上的销售方地址电话识别结果。
vat_invoice_payer_name购买方名称增值税发票上的购买方名称识别结果。
vat_invoice_payer_bank_account购买方开户行及账号增值税发票上的购买方开户行及账号识别结果。
vat_invoice_payer_addr_tell购买方地址电话增值税发票上的购买方地址电话识别结果。
vat_invoice_total_cover_tax价税合计大写增值税发票上的价税合计大写识别结果。
vat_invoice_total_cover_tax_digits价税合计小写增值税发票上的价税合计小写识别结果。
vat_invoice_tax_total税额合计增值税发票上的税额合计识别结果。
vat_invoice_goods_list货物或服务名称增值税发票上的货物或服务名称识别结果。
vat_invoice_price_list金额明细增值税发票上的金额明细识别结果。
vat_invoice_tax_rate_list税率明细增值税发票上的税率明细识别结果。
vat_invoice_tax_list税额明细增值税发票上的税额明细识别结果。
vat_invoice_zhuan_yong_flag专票/普票增值税发票上的专票/普票识别结果。
vat_invoice_dai_kai_flag代开增值税发票上代开识别结果。
vat_invoice_note备注增值税发票上的右侧打印发票代码识别结果
vat_invoice_daima_right_side右侧打印发票代码增值税发票上的右侧打印发票代码识别结果
vat_invoice_haoma_right_side右侧打印发票号码增值税发票上的右侧打印发票号码识别结果。
time_cost识别耗时以毫秒为单位。
error_code错误码识别错误码。
error_msg错误描述错误原因描述。

结果示例如下：

失败：

  1. {
  2.     "code": "10105",
  3.     "desc": "illegal access|illegal X-CheckSum",
  4.     "data": "",
  5.     "sid": "wcr00001224@dxe4290f1b561c6f2b00"
  6. }

成功:

  1. {
  2.     "code": "0",
  3.     "data": {
  4.         "error_code": 0,
  5.         "error_msg": "OK",
  6.         "time_cost": {
  7.             "preprocess": 22,
  8.             "recognize": 2473
  9.         },
  10.         "type": "增值税发票",
  11.         "vat_invoice_correct_code": "64974132813525186653",
  12.         "vat_invoice_correct_code_pos": {
  13.             "height": 43,
  14.             "left": 393,
  15.             "top": 174,
  16.             "width": 436
  17.         },
  18.         "vat_invoice_daima": "034011700111",
  19.         "vat_invoice_daima_pos": {
  20.             "height": 125,
  21.             "left": 422,
  22.             "top": 31,
  23.             "width": 318
  24.         },
  25.         "vat_invoice_goods_list": "*餐饮服务*餐费",
  26.         "vat_invoice_goods_list_pos": {
  27.             "height": 255,
  28.             "left": 304,
  29.             "top": 347,
  30.             "width": 332
  31.         },
  32.         "vat_invoice_haoma": "09445857",
  33.         "vat_invoice_haoma_pos": {
  34.             "height": 110,
  35.             "left": 1145,
  36.             "top": 55,
  37.             "width": 447
  38.         },
  39.         "vat_invoice_issue_date": "2018年07月19日",
  40.         "vat_invoice_issue_date_pos": {
  41.             "height": 63,
  42.             "left": 1295,
  43.             "top": 148,
  44.             "width": 297
  45.         },
  46.         "vat_invoice_jida_haoma": "09445857",
  47.         "vat_invoice_payer_name": "科大讯飞股份有限公司",
  48.         "vat_invoice_payer_name_pos": {
  49.             "height": 40,
  50.             "left": 349,
  51.             "top": 195,
  52.             "width": 693
  53.         },
  54.         "vat_invoice_price_list": "678.30",
  55.         "vat_invoice_price_list_pos": {
  56.             "height": 52,
  57.             "left": 1136,
  58.             "top": 362,
  59.             "width": 207
  60.         },
  61.         "vat_invoice_rate_payer_id": "91340000711771143J",
  62.         "vat_invoice_rate_payer_id_pos": {
  63.             "height": 62,
  64.             "left": 349,
  65.             "top": 225,
  66.             "width": 693
  67.         },
  68.         "vat_invoice_seller_addr_tell": "安徽省合肥市蜀山区黄山路与怀宁路路口中皖金大地1912\"A区7号棱一楼三棱局部A7-6商铺0551-65128129",
  69.         "vat_invoice_seller_addr_tell_pos": {
  70.             "height": 61,
  71.             "left": 349,
  72.             "top": 719,
  73.             "width": 693
  74.         },
  75.         "vat_invoice_seller_bank_account": "中国民生银行股份有限公司合肥分行699685583",
  76.         "vat_invoice_seller_bank_account_pos": {
  77.             "height": 60,
  78.             "left": 349,
  79.             "top": 749,
  80.             "width": 693
  81.         },
  82.         "vat_invoice_seller_id": "91340100MA2NG9JTIN",
  83.         "vat_invoice_seller_id_pos": {
  84.             "height": 61,
  85.             "left": 349,
  86.             "top": 690,
  87.             "width": 693
  88.         },
  89.         "vat_invoice_seller_name": "四川新派餐饮管理有限公司合肥黄山路分公司",
  90.         "vat_invoice_seller_name_pos": {
  91.             "height": 38,
  92.             "left": 349,
  93.             "top": 661,
  94.             "width": 693
  95.         },
  96.         "vat_invoice_tax_list": "40.70",
  97.         "vat_invoice_tax_list_pos": {
  98.             "height": 52,
  99.             "left": 1387,
  100.             "top": 362,
  101.             "width": 200
  102.         },
  103.         "vat_invoice_tax_rate": "6%",
  104.         "vat_invoice_tax_rate_list": "6%",
  105.         "vat_invoice_tax_rate_list_pos": {
  106.             "height": 52,
  107.             "left": 1327,
  108.             "top": 362,
  109.             "width": 76
  110.         },
  111.         "vat_invoice_tax_rate_pos": {
  112.             "height": 52,
  113.             "left": 1327,
  114.             "top": 362,
  115.             "width": 76
  116.         },
  117.         "vat_invoice_tax_total": "¥40.70",
  118.         "vat_invoice_tax_total_pos": {
  119.             "height": 85,
  120.             "left": 1387,
  121.             "top": 553,
  122.             "width": 192
  123.         },
  124.         "vat_invoice_total": "¥678.30",
  125.         "vat_invoice_total_cover_tax": "柒佰壹拾玖圆整",
  126.         "vat_invoice_total_cover_tax_digits": "¥719.00",
  127.         "vat_invoice_total_cover_tax_digits_pos": {
  128.             "height": 54,
  129.             "left": 635,
  130.             "top": 623,
  131.             "width": 937
  132.         },
  133.         "vat_invoice_total_cover_tax_pos": {
  134.             "height": 54,
  135.             "left": 635,
  136.             "top": 623,
  137.             "width": 937
  138.         },
  139.         "vat_invoice_total_pos": {
  140.             "height": 84,
  141.             "left": 1136,
  142.             "top": 554,
  143.             "width": 214
  144.         },
  145.         "vat_invoice_type": "电子普通发票",
  146.         "vat_invoice_zhuan_yong_flag": "普票"
  147.     },
  148.     "desc": "success",
  149.     "sid": "wcr000011f2@dxe4290f1b549b6f2b00"
  150. }

5. 调用示例

增值税发票识别demo go语言

增值税发票识别demo php语言

增值税发票识别demo java语言

增值税发票识别demo python3语言

增值税发票识别demo c#语言

Copyright © iflytek.com 2018 all right reserved，powered by Gitbook该文件修订时间：2019-05-07 07:12:51