智能财务票据识别
接口描述
支持财务场景中13种常见票据的分类及结构化识别,包括增值税发票、卷票、机打发票、定额发票、火车票(含电子发票铁路电子客票)、出租车票、网约车行程单、飞机行程单(含电子发票航空电子客票行程单)、汽车票、过路过桥费、船票、机动车/二手车销售发票。支持多张不同种类票据在同一张图片上的混贴场景,可返回每张票据的位置、种类及票面信息的结构化识别结果。
视频教程请参见 智能财务票据识别+增值税发票验真使用教程
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/x-www-form-urlencoded |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
---|---|---|---|---|
image | 和 url/pdf_file/ofd_file 四选一 | string | - | 图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式 优先级:image > url > pdf_file > ofd_file ,当image字段存在时,url、pdf_file、ofd_file 字段失效 |
url | 和 image/pdf_file/ofd_file 四选一 | string | - | 图片完整url,url长度不超过1024字节,url对应的图片base64编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/jpeg/png/bmp格式优先级:image > url > pdf_file > ofd_file,当image字段存在时,url字段失效请注意关闭URL防盗链 |
pdf_file | 和 image/url/ofd_file 四选一 | string | - | PDF文件,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px优先级:image > url > pdf_file > ofd_file,当image、url字段存在时,pdf_file字段失效 |
pdf_file_num | 否 | string | - | 需要识别的PDF文件的对应页码,当 pdf_file 参数有效时,识别传入页码的对应页面内容,若不传入,则默认识别第 1 页 |
ofd_file | 和 image/url/pdf_file 四选一 | string | - | OFD文件,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,最短边至少15px,最长边最大4096px优先级:image > url > pdf_file > ofd_file,当image、url、pdf_file字段存在时,ofd_file字段失效 |
ofd_file_num | 否 | string | - | 需要识别的OFD文件的对应页码,当 ofd_file 参数有效时,识别传入页码的对应页面内容,若不传入,则默认识别第 1 页 |
verify_parameter | 否 | string | true/false | 是否开启验真,默认为 false,即不开启,当为 true 时,返回匹配发票验真接口所需的6要素信息,具体返回信息详见末尾说明 |
probability | 否 | string | true/false | 是否返回字段置信度,默认为 false ,即不返回 |
location | 否 | string | true/false | 是否返回字段位置坐标,默认为 false,即不返回 |
请求代码示例
提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
1curl -i -k 'https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice?access_token=【调用鉴权接口获取的token】' --data 'image=【图片Base64编码,需UrlEncode】' -H 'Content-Type:application/x-www-form-urlencoded'
1# encoding:utf-8
2
3import requests
4import base64
5
6'''
7智能财务票据识别
8'''
9
10request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice"
11# 二进制方式打开图片文件
12f = open('[本地文件]', 'rb')
13img = base64.b64encode(f.read())
14
15params = {"image":img}
16access_token = '[调用鉴权接口获取的token]'
17request_url = request_url + "?access_token=" + access_token
18headers = {'content-type': 'application/x-www-form-urlencoded'}
19response = requests.post(request_url, data=params, headers=headers)
20if response:
21 print (response.json())
1package com.baidu.ai.aip;
2
3import com.baidu.ai.aip.utils.Base64Util;
4import com.baidu.ai.aip.utils.FileUtil;
5import com.baidu.ai.aip.utils.HttpUtil;
6
7import java.net.URLEncoder;
8
9/**
10* 智能财务票据识别
11*/
12public class MultipleInvoice {
13
14 /**
15 * 重要提示代码中所需工具类
16 * FileUtil,Base64Util,HttpUtil,GsonUtils请从
17 * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72
18 * https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2
19 * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3
20 * https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3
21 * 下载
22 */
23 public static String multipleInvoice() {
24 // 请求url
25 String url = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice";
26 try {
27 // 本地文件路径
28 String filePath = "[本地文件路径]";
29 byte[] imgData = FileUtil.readFileByBytes(filePath);
30 String imgStr = Base64Util.encode(imgData);
31 String imgParam = URLEncoder.encode(imgStr, "UTF-8");
32
33 String param = "image=" + imgParam;
34
35 // 注意这里仅为了简化编码每一次请求都去获取access_token,线上环境access_token有过期时间, 客户端可自行缓存,过期后重新获取。
36 String accessToken = "[调用鉴权接口获取的token]";
37
38 String result = HttpUtil.post(url, accessToken, param);
39 System.out.println(result);
40 return result;
41 } catch (Exception e) {
42 e.printStackTrace();
43 }
44 return null;
45 }
46
47 public static void main(String[] args) {
48 MultipleInvoice.multipleInvoice();
49 }
50}
1#include <iostream>
2#include <curl/curl.h>
3
4// libcurl库下载链接:https://curl.haxx.se/download.html
5// jsoncpp库下载链接:https://github.com/open-source-parsers/jsoncpp/
6const static std::string request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice";
7static std::string multipleInvoice_result;
8/**
9* curl发送http请求调用的回调函数,回调函数中对返回的json格式的body进行了解析,解析结果储存在全局的静态变量当中
10* @param 参数定义见libcurl文档
11* @return 返回值定义见libcurl文档
12*/
13static size_t callback(void *ptr, size_t size, size_t nmemb, void *stream) {
14 // 获取到的body存放在ptr中,先将其转换为string格式
15 multipleInvoice_result = std::string((char *) ptr, size * nmemb);
16 return size * nmemb;
17}
18/**
19* 智能财务票据识别
20* @return 调用成功返回0,发生错误返回其他错误码
21*/
22int multipleInvoice(std::string &json_result, const std::string &access_token) {
23 std::string url = request_url + "?access_token=" + access_token;
24 CURL *curl = NULL;
25 CURLcode result_code;
26 int is_success;
27 curl = curl_easy_init();
28 if (curl) {
29 curl_easy_setopt(curl, CURLOPT_URL, url.data());
30 curl_easy_setopt(curl, CURLOPT_POST, 1);
31 curl_httppost *post = NULL;
32 curl_httppost *last = NULL;
33 curl_formadd(&post, &last, CURLFORM_COPYNAME, "image", CURLFORM_COPYCONTENTS, "【base64_img】", CURLFORM_END);
34
35 curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);
36 curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, callback);
37 result_code = curl_easy_perform(curl);
38 if (result_code != CURLE_OK) {
39 fprintf(stderr, "curl_easy_perform() failed: %s\n",
40 curl_easy_strerror(result_code));
41 is_success = 1;
42 return is_success;
43 }
44 json_result = multipleInvoice_result;
45 curl_easy_cleanup(curl);
46 is_success = 0;
47 } else {
48 fprintf(stderr, "curl_easy_init() failed.");
49 is_success = 1;
50 }
51 return is_success;
52}
1<?php
2/**
3* 发起http post请求(REST API), 并获取REST请求的结果
4* @param string $url
5* @param string $param
6* @return - http response body if succeeds, else false.
7*/
8function request_post($url = '', $param = '')
9{
10 if (empty($url) || empty($param)) {
11 return false;
12 }
13
14 $postUrl = $url;
15 $curlPost = $param;
16 // 初始化curl
17 $curl = curl_init();
18 curl_setopt($curl, CURLOPT_URL, $postUrl);
19 curl_setopt($curl, CURLOPT_HEADER, 0);
20 // 要求结果为字符串且输出到屏幕上
21 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
22 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
23 // post提交方式
24 curl_setopt($curl, CURLOPT_POST, 1);
25 curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);
26 // 运行curl
27 $data = curl_exec($curl);
28 curl_close($curl);
29
30 return $data;
31}
32
33$token = '[调用鉴权接口获取的token]';
34$url = 'https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice?access_token=' . $token;
35$img = file_get_contents('[本地文件路径]');
36$img = base64_encode($img);
37$bodys = array(
38 'image' => $img
39);
40$res = request_post($url, $bodys);
41
42var_dump($res);
1using System;
2using System.IO;
3using System.Net;
4using System.Text;
5using System.Web;
6
7namespace com.baidu.ai
8{
9 public class MultipleInvoice
10 {
11 // 智能财务票据识别
12 public static string multipleInvoice()
13 {
14 string token = "[调用鉴权接口获取的token]";
15 string host = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice?access_token=" + token;
16 Encoding encoding = Encoding.Default;
17 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);
18 request.Method = "post";
19 request.KeepAlive = true;
20 // 图片的base64编码
21 string base64 = getFileBase64("[本地图片文件]");
22 String str = "image=" + HttpUtility.UrlEncode(base64);
23 byte[] buffer = encoding.GetBytes(str);
24 request.ContentLength = buffer.Length;
25 request.GetRequestStream().Write(buffer, 0, buffer.Length);
26 HttpWebResponse response = (HttpWebResponse)request.GetResponse();
27 StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);
28 string result = reader.ReadToEnd();
29 Console.WriteLine("智能财务票据识别:");
30 Console.WriteLine(result);
31 return result;
32 }
33
34 public static String getFileBase64(String fileName) {
35 FileStream filestream = new FileStream(fileName, FileMode.Open);
36 byte[] arr = new byte[filestream.Length];
37 filestream.Read(arr, 0, (int)filestream.Length);
38 string baser64 = Convert.ToBase64String(arr);
39 filestream.Close();
40 return baser64;
41 }
42 }
43}
返回说明
返回参数
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
log_id | 是 | uint64 | 唯一的log id,用于问题定位 |
pdf_file_size | 否 | string | 传入PDF文件的总页数,当 pdf_file 参数有效时返回该字段 |
words_result_num | 是 | uint32 | 识别结果数,表示words_result的元素个数 |
words_result | 是 | object{} | 识别结果 |
+ probability | 是 | string | 表示单张票据分类的置信度 |
+ left | 是 | string | 表示单张票据定位位置的长方形左上顶点的水平坐标 |
+ top | 是 | string | 表示单张票据定位位置的长方形左上顶点的垂直坐标 |
+ width | 是 | string | 表示单张票据定位位置的长方形的宽度 |
+ height | 是 | string | 表示单张票据定位位置的长方形的高度 |
+ type | 是 | string | 每一张票据的种类 |
+ result | 是 | dict | 单张票据的识别结果 |
type 字段会返回以下17种结果,每种结果对应的票据类型详见下表
type 返回结果 | 说明 |
---|---|
vat_invoice | 增值税发票 |
taxi_receipt | 出租车票 |
train_ticket | 火车票 |
quota_invoice | 定额发票 |
air_ticket | 飞机行程单 |
roll_normal_invoice | 卷票 |
printed_invoice | 机打发票 |
printed_elec_invoice | 机打电子发票 |
bus_ticket | 汽车票 |
toll_invoice | 过路过桥费发票 |
ferry_ticket | 船票 |
motor_vehicle_invoice | 机动车销售发票 |
used_vehicle_invoice | 二手车发票 |
taxi_online_ticket | 网约车行程单 |
limit_invoice | 限额发票 |
shopping_receipt | 购物小票 |
pos_invoice | POS小票 |
others | 其他 |
返回说明-增值税发票
type 的返回结果为 vat_invoice,即“增值税发票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。不同消费类型输出:餐饮、电器设备、通讯、服务、日用品食品、医疗、交通、其他 |
++ InvoiceTypeOrg | 是 | array[] | 发票名称 |
++ InvoiceType | 是 | array[] | 增值税发票的细分类型。 不同细分类型的发票输出:普通发票、专用发票、电子普通发票、电子专用发票、通行费电子普票、区块链发票、通用机打电子发票、电子发票(专用发票)、电子发票(普通发票) |
++ InvoiceTag | 是 | array[] | 增值税发票左上角标志。 包含:通行费、销项负数、代开、收购、成品油、其他 |
++ InvoiceCode | 是 | array[] | 发票代码 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ InvoiceCodeConfirm | 是 | array[] | 发票代码的辅助校验码,一般业务情景可忽略 |
++ InvoiceNumConfirm | 是 | array[] | 发票号码的辅助校验码,一般业务情景可忽略 |
++ CheckCode | 是 | array[] | 校验码。增值税专票无此参数 |
++ InvoiceNumDigit | 是 | array[] | 数电票号码。密码区部分的数电票号码,仅在纸质的数电票上出现 |
++ InvoiceDate | 是 | array[] | 开票日期 |
++ PurchaserName | 是 | array[] | 购方名称 |
++ PurchaserRegisterNum | 是 | array[] | 购方纳税人识别号 |
++ PurchaserAddress | 是 | array[] | 购方地址及电话 |
++ PurchaserBank | 是 | array[] | 购方开户行及账号 |
++ Password | 是 | array[] | 密码区 |
++ Province | 是 | array[] | 省 |
++ City | 是 | array[] | 市 |
++ SheetNum | 是 | array[] | 联次信息。专票第一联到第三联分别输出:第一联:记账联、第二联:抵扣联、第三联:发票联;普通发票第一联到第二联分别输出:第一联:记账联、第二联:发票联 |
++ Agent | 是 | array[] | 是否代开 |
++ OnlinePay | 是 | String | 电子支付标识。仅区块链发票含有此参数 |
++ SellerName | 是 | array[] | 销售方名称 |
++ SellerRegisterNum | 是 | array[] | 销售方纳税人识别号 |
++ SellerAddress | 是 | array[] | 销售方地址及电话 |
++ SellerBank | 是 | array[] | 销售方开户行及账号 |
++ TotalAmount | 是 | array[] | 合计金额 |
++ TotalTax | 是 | array[] | 合计税额 |
++ AmountInWords | 是 | array[] | 价税合计(大写) |
++ AmountInFiguers | 是 | array[] | 价税合计(小写) |
++ Payee | 是 | array[] | 收款人 |
++ Checker | 是 | array[] | 复核 |
++ NoteDrawer | 是 | array[] | 开票人 |
++ Remarks | 是 | array[] | 备注 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
++ CommodityName | 是 | array[] | 货物名称 |
++ CommodityType | 是 | array[] | 规格型号 |
++ CommodityUnit | 是 | array[] | 单位 |
++ CommodityNum | 是 | array[] | 数量 |
++ CommodityPrice | 是 | array[] | 单价 |
++ CommodityAmount | 是 | array[] | 金额 |
++ CommodityTaxRate | 是 | array[] | 税率 |
++ CommodityTax | 是 | array[] | 税额 |
++ CommodityPlateNum | 是 | array[] | 车牌号。仅通行费增值税电子普通发票含有此参数,其余类型该参数返回为空 |
++ CommodityVehicleType | 是 | array[] | 类型。仅通行费增值税电子普通发票含有此参数,其余类型该参数返回为空 |
++ CommodityStartDate | 是 | array[] | 通行日期起。仅通行费增值税电子普通发票含有此参数,其余类型该参数返回为空 |
++ CommodityEndDate | 是 | array[] | 通行日期止。仅通行费增值税电子普通发票含有此参数,其余类型该参数返回为空 |
++ PassengName | 是 | array[] | 出行人。仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ PassengIdNum | 是 | array[] | 有效身份证件号,仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ PassengDate | 是 | array[] | 出行日期。仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ PassengOrigin | 是 | array[] | 出发地。仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ PassengDestination | 是 | array[] | 到达地。仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ PassengClass | 是 | array[] | 等级。仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ PassengVehicleType | 是 | array[] | 交通工具类型。仅旅客运输类发票有此参数,其余类型该参数返回为空 |
++ TransportType | 是 | array[] | 运输工具种类。仅货物运输类发票有此参数,其余类型该参数返回为空 |
++ TransportPlateNum | 是 | array[] | 运输工具牌号。仅货物运输类发票有此参数,其余类型该参数返回为空 |
++ TransportDeparture | 是 | array[] | 起运地。仅货物运输类发票有此参数,其余类型该参数返回为空 |
++ TransportArrival | 是 | array[] | 到达地。仅货物运输类发票有此参数,其余类型该参数返回为空 |
++ TransportCargoInfo | 是 | array[] | 运输货物名称。仅货物运输类发票有此参数,其余类型该参数返回为空 |
+++ row | 是 | uint32 | 行号,以上各字段均包含 |
+++ word | 是 | string | 内容,以上各字段均包含 |
返回说明-出租车票
type 的返回结果为 taxi_receipt,即“出租车票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。出租车票此字段固定输出:交通 |
++ InvoiceCode | 是 | array[] | 发票代号 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ TaxiNum | 是 | array[] | 车牌号 |
++ Date | 是 | array[] | 日期 |
++ Time | 是 | array[] | 上下车时间 |
++ PickupTime | 是 | array[] | 上车时间 |
++ DropoffTime | 是 | array[] | 下车时间 |
++ Fare | 是 | array[] | 金额 |
++ FuelOilSurcharge | 是 | array[] | 燃油附加费 |
++ CallServiceSurcharge | 是 | array[] | 叫车服务费 |
++ TotalFare | 是 | array[] | 总金额 |
++ Location | 是 | array[] | 开票城市 |
++ Province | 是 | array[] | 省 |
++ City | 是 | array[] | 市 |
++ PricePerkm | 是 | array[] | 单价 |
++ Distance | 是 | array[] | 里程 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-火车票
type 的返回结果为 train_ticket,即“火车票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。火车票此字段固定输出:交通 |
++ ticket_num | 是 | array[] | 车票号 |
++ starting_station | 是 | array[] | 始发站 |
++ train_num | 是 | array[] | 车次号 |
++ destination_station | 是 | array[] | 到达站 |
++ date | 是 | array[] | 出发日期 |
++ ticket_rates | 是 | array[] | 车票金额,当火车票为退票时,该字段表示退票费 |
++ seat_category | 是 | array[] | 席别 |
++ name | 是 | array[] | 乘客姓名 |
++ ID_card | 是 | array[] | 身份证号 |
++ serial_number | 是 | array[] | 序列号 |
++ sales_station | 是 | array[] | 售站 |
++ time | 是 | array[] | 时间 |
++ seat_num | 是 | array[] | 座位号 |
++ Waiting_area | 是 | array[] | 候检区 |
++ refund_flag | 否 | array[] | 标识,仅在输入为铁路电子客票时返回值,包括“退票”、“换开”、“始发改签”等 |
++ invoice_num | 否 | array[] | 发票号码 |
++ invoice_date | 否 | array[] | 开票日期 |
++ fare | 否 | array[] | 不含税金额 |
++ tax_rate | 否 | array[] | 税率 |
++ tax | 否 | array[] | 税额 |
++ elec_ticket_num | 否 | array[] | 电子客票号 |
++purchaser_name | 否 | array[] | 购买方名称 |
++purchaser_register_num | 否 | array[] | 购买方统一社会信用代码 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-定额发票
type 的返回结果为 quota_invoice,即“定额发票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。定额发票此字段固定输出:交通 |
++ invoice_code | 是 | array[] | 发票代码 |
++ invoice_number | 是 | array[] | 发票号码 |
++ invoice_rate | 是 | array[] | 金额 |
++ invoice_rate_in_figure | 是 | array[] | 金额小写 |
++ invoice_rate_in_word | 是 | array[] | 金额大写 |
++ Province | 是 | array[] | 省 |
++ City | 是 | array[] | 市 |
++ Location | 是 | array[] | 发票所在地 |
++ invoice_type | 是 | array[] | 发票名称 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-飞机行程单
type 的返回结果为 air_ticket,即“飞机行程单”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。飞机行程单此字段固定输出:交通 |
++ name | 是 | array[] | 姓名 |
++ starting_station | 是 | array[] | 始发站 |
++ destination_station | 是 | array[] | 目的站 |
++ flight | 是 | array[] | 航班号 |
++ date | 是 | array[] | 日期 |
++ ticket_number | 是 | array[] | 电子客票号码 |
++ fare | 是 | array[] | 票价 |
++ dev_fund | 是 | array[] | 民航发展基金/机建费 |
++ oil_money | 是 | array[] | 燃油附加费 |
++ other_tax | 是 | array[] | 其他税费 |
++ ticket_rates | 是 | array[] | 合计金额 |
++ start_date | 是 | array[] | 填开日期 |
++ id_no | 是 | array[] | 身份证号 |
++ carrier | 是 | array[] | 承运人 |
++ time | 是 | array[] | 时间 |
++ issued_by | 是 | array[] | 填开单位 |
++ serial_number | 是 | array[] | 印刷序号 |
++ insurance | 是 | array[] | 保险费 |
++ fare_basis | 是 | array[] | 客票级别 |
++ class | 是 | array[] | 座位等级 |
++ agent_code | 是 | array[] | 销售单位号 |
++ endorsement | 是 | array[] | 签注 |
++ allow | 是 | array[] | 免费行李 |
++ ck | 是 | array[] | 验证码 |
++ effective_date | 是 | array[] | 客票生效日期 |
++ expiration_date | 是 | array[] | 有效期截止日期 |
++ invoice_type_org | 是 | array[] | 发票名称 |
++ identification | 是 | array[] | 国内国际标识 |
++ invoice_status | 是 | array[] | 开票状态 |
++ invoice_num | 是 | array[] | 发票号码 |
++ commodity_tax_rate | 是 | array[] | 增值税税率 |
++ commodity_tax | 是 | array[] | 增值税税额 |
++ purchaser_name | 是 | array[] | 购买方名称 |
++ purchaser_register_num | 是 | array[] | 统一社会信用代码/纳税人识别号 |
++ tip | 是 | array[] | 提示信息 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-卷票
type 的返回结果为 roll_normal_invoice,即“卷票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ InvoiceType | 是 | array[] | 发票名称 |
++ InvoiceCode | 是 | array[] | 发票代码 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ MachineNum | 是 | array[] | 机打号码。仅增值税卷票含有此参数 |
++ MachineCode | 是 | array[] | 机器编号。仅增值税卷票含有此参数 |
++ InvoiceDate | 是 | array[] | 开票日期 |
++ PurchaserName | 是 | array[] | 购方名称 |
++ PurchaserRegisterNum | 是 | array[] | 购方纳税人识别号 |
++ SellerName | 是 | array[] | 销售方名称 |
++ SellerRegisterNum | 是 | array[] | 销售方纳税人识别号 |
++ TotalTax | 是 | array[] | 价税合计 |
++ AmountInWords | 是 | array[] | 合计金额(大写) |
++ AmountInFiguers | 是 | array[] | 合计金额(小写) |
++ Payee | 是 | array[] | 收款人 |
++ CheckCode | 是 | array[] | 校验码。增值税专票无此参数 |
++ Province | 是 | array[] | 省 |
++ City | 是 | array[] | 市 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
++ CommodityName | 是 | array[] | 货物名称 |
++ CommodityNum | 是 | array[] | 数量 |
++ CommodityPrice | 是 | array[] | 单价 |
++ CommodityAmount | 是 | array[] | 金额 |
+++ row | 是 | uint32 | 行号,以上各字段均包含 |
+++ word | 是 | string | 内容,以上各字段均包含 |
返回说明-机打发票
type 的返回结果为 printed_invoice,即“机打发票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。不同消费类型输出:餐饮、电器设备、通讯、服务、日用品食品、医疗、交通、其他 |
++ InvoiceType | 是 | array[] | 发票类型 |
++ InvoiceCode | 是 | array[] | 发票代码 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ InvoiceDate | 是 | array[] | 开票日期 |
++ AmountInFiguers | 是 | array[] | 合计金额小写 |
++ AmountInWords | 是 | array[] | 合计金额大写 |
++ MachineNum | 是 | array[] | 机打号码 |
++ CheckCode | 是 | array[] | 校验码 |
++ SellerName | 是 | array[] | 销售方名称 |
++ SellerRegisterNum | 是 | array[] | 销售方纳税人识别号 |
++ PurchaserName | 是 | array[] | 购买方名称 |
++ PurchaserRegisterNum | 是 | array[] | 购买方纳税人识别号 |
++ TotalTax | 是 | array[] | 合计税额 |
++ Province | 是 | array[] | 省 |
++ City | 是 | array[] | 市 |
++ Time | 是 | array[] | 时间 |
++ SheetNum | 是 | array[] | 联次 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
++ CommodityName | 是 | array[] | 商品名称 |
++ CommodityUnit | 是 | array[] | 商品单位 |
++ CommodityPrice | 是 | array[] | 商品单价 |
++ CommodityNum | 是 | array[] | 商品数量 |
++ CommodityAmount | 是 | array[] | 商品金额 |
+++ row | 是 | uint32 | 行号,以上各字段均包含 |
+++ word | 是 | string | 内容,以上各字段均包含 |
返回说明-汽车票
type 的返回结果为 bus_ticket,即“汽车票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。汽车票此字段固定输出:交通 |
++ InvoiceCode | 是 | array[] | 发票代码 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ Date | 是 | array[] | 日期 |
++ Time | 是 | array[] | 时间 |
++ ExitStation | 是 | array[] | 出发站 |
++ Amount | 是 | array[] | 金额 |
++ IdCard | 是 | array[] | 身份证号 |
++ ArrivalStation | 是 | array[] | 到达站 |
++ Name | 是 | array[] | 姓名 |
++ InvoiceTime | 是 | array[] | 开票日期 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-过路过桥费
type 的返回结果为 toll_invoice,即“过路过桥费”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。过路过桥费此字段固定输出:交通 |
++ InvoiceCode | 是 | array[] | 发票代码 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ Entrance | 是 | array[] | 入口 |
++ Exit | 是 | array[] | 出口 |
++ OutDate | 是 | array[] | 日期 |
++ OutTime | 是 | array[] | 时间 |
++ TotalAmount | 是 | array[] | 金额 |
++ Province | 是 | array[] | 省 |
++ City | 是 | array[] | 市 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-船票
type 的返回结果为 ferry_ticket,即“船票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。船票此字段固定输出:交通 |
++ InvoiceType | 是 | array[] | 发票类型 |
++ InvoiceCode | 是 | array[] | 发票代码 |
++ InvoiceNum | 是 | array[] | 发票号码 |
++ ExitStation | 是 | array[] | 出发地点 |
++ ArrivalStation | 是 | array[] | 到达地点 |
++ Amount | 是 | array[] | 总金额 |
++ Date | 是 | array[] | 开票日期 |
++ MoneyType | 是 | array[] | 金额类型 |
++ BarCode | 是 | array[] | 条码 |
++ BarCodeNum | 是 | array[] | 条码编号 |
++ City | 是 | array[] | 市 |
++ Province | 是 | array[] | 省 |
++ InvoiceTitle | 是 | array[] | 发票抬头,这里指该张船票的运行公司名 |
++ QrCode | 是 | array[] | 二维码 |
++ Time | 是 | array[] | 出发时间 |
++ TicketTime | 是 | array[] | 制票时间 |
++ TicketDate | 是 | array[] | 制票日期 |
++ PassengerName | 是 | array[] | 乘客姓名 |
++ IdCard | 是 | array[] | 乘客身份证号 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-机动车销售发票
type 的返回结果为 motor_vehicle_invoice,即“机动车销售发票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ date | 是 | array[] | 开票日期 |
++ fapiao-daima | 是 | array[] | 发票代码 |
++ fapiao-haoma | 是 | array[] | 发票号码 |
++ printed-daima | 是 | array[] | 机打代码 |
++ printed-haoma | 是 | array[] | 机打号码 |
++ machine-num | 是 | array[] | 机器编号 |
++ buyer-name | 是 | array[] | 购买方名称 |
++ payer-tax-num | 是 | array[] | 纳税人识别号/统一社会信用代码/身份证号码 |
++ car-class | 是 | array[] | 车辆类型 |
++ car-model | 是 | array[] | 厂牌型号 |
++ product-location | 是 | array[] | 产地 |
++ certificate-num | 是 | array[] | 合格证号 |
++ engine-num | 是 | array[] | 发动机号码 |
++ vin-num | 是 | array[] | 车辆识别代号/车架号码 |
++ price-tax-big | 是 | array[] | 价税合计 |
++ price-tax-small | 是 | array[] | 价税合计小写 |
++ saler | 是 | array[] | 销货单位名称 |
++ saler-phone | 是 | array[] | 销货单位电话 |
++ saler-tax-num | 是 | array[] | 销货单位纳税人识别号 |
++ saler-bank-num | 是 | array[] | 销货单位账号 |
++ saler-address | 是 | array[] | 销货单位地址 |
++ saler-bank | 是 | array[] | 销货单位开户银行 |
++ tax-rate | 是 | array[] | 税率 |
++ tax | 是 | array[] | 税额 |
++ tax-jiguan | 是 | array[] | 主管税务机关 |
++ tax-jiguan-daima | 是 | array[] | 主管税务机关代码 |
++ price | 是 | array[] | 不含税价格 |
++ limit-mount | 是 | array[] | 限乘人数 |
++ toonage | 是 | array[] | 吨位 |
++ sheet-num | 是 | array[] | 联次 |
++ drawer | 是 | array[] | 开票人 |
++ remarks | 是 | array[] | 备注 |
++ import-certificate-num | 是 | array[] | 进口证明书号 |
++ tax-payment-voucher-no | 是 | array[] | 完整凭税编号 |
++ inspection-form-num | 是 | array[] | 商检单号 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-二手车销售发票
type 的返回结果为 used_vehicle_invoice,即“二手车销售发票”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ invoice_code | 是 | array[] | 发票代码 |
++ invoice_num | 是 | array[] | 发票号码 |
++ date | 是 | array[] | 开票日期 |
++ tax_code | 是 | array[] | 税控码 |
++ buyer | 是 | array[] | 买方 |
++ buyer_id | 是 | array[] | 买方身份证号 |
++ buyer_station | 是 | array[] | 买方地址 |
++ buyer_tel | 是 | array[] | 买方电话 |
++ saler | 是 | array[] | 卖方 |
++ saler_id | 是 | array[] | 卖方身份证号 |
++ saler_station | 是 | array[] | 卖方地址 |
++ saler_tel | 是 | array[] | 卖方电话 |
++ car_plate | 是 | array[] | 车牌号 |
++ car_certificate | 是 | array[] | 登记证号 |
++ car_class | 是 | array[] | 车辆类型 |
++ vin_num | 是 | array[] | 车架号 |
++ model | 是 | array[] | 厂牌型号 |
++ to_station | 是 | array[] | 转入地车管所名称 |
++ big_price | 是 | array[] | 车价合计大写 |
++ small_price | 是 | array[] | 车价合计小写 |
++ car_market | 是 | array[] | 二手车市场 |
++ tax_num | 是 | array[] | 纳税人识别号 |
++ tax_location | 是 | array[] | 纳税人地址 |
++ tax_tel | 是 | array[] | 纳税人电话 |
++ sheet_num | 是 | array[] | 联次 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-网约车行程单
type 的返回结果为 taxi_online_ticket,即“网约车行程单”时,识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ ServiceType | 是 | array[] | 发票消费类型。网约车行程单此字段固定输出:交通 |
++ service_provider | 是 | array[] | 服务商 |
++ start_time | 是 | array[] | 行程开始时间 |
++ destination_time | 是 | array[] | 行程结束时间 |
++ phone | 是 | array[] | 行程人手机号 |
++ application_date | 是 | array[] | 申请日期 |
++ total_fare | 是 | array[] | 总金额 |
++ item_num | 是 | array[] | 行程信息中包含的行程数量 |
+++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
++ items | 是 | array[] | 行程信息 |
+++ item_id | 是 | array[] | 行程信息的对应序号 |
+++ item_provider | 是 | array[] | 行程信息的对应服务商 |
+++ pickup_time | 是 | array[] | 上车时间 |
+++ pickup_date | 是 | array[] | 上车日期 |
+++ car_type | 是 | array[] | 车型 |
+++ distance | 是 | array[] | 里程 |
+++ start_place | 是 | array[] | 起点 |
+++ destination_place | 是 | array[] | 终点 |
+++ city | 是 | array[] | 城市 |
+++ fare | 是 | array[] | 金额 |
++++ word | 是 | string | 识别结果字符串,以上各字段均包含 |
返回说明-限额发票
type 的返回结果为 limit_invoice,即“限额发票”时,由于此类型仅支持检测分类,无法识别具体票据内容。识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
words_result | 是 | object{} | 识别结果 |
+ probability | 是 | string | 表示单张票据分类的置信度 |
+ left | 是 | string | 表示单张票据定位位置的长方形左上顶点的水平坐标 |
+ top | 是 | string | 表示单张票据定位位置的长方形左上顶点的垂直坐标 |
+ width | 是 | string | 表示单张票据定位位置的长方形的宽度 |
+ height | 是 | string | 表示单张票据定位位置的长方形的高度 |
+ type | 是 | string | limit_invoice |
返回说明-购物小票
type 的返回结果为 shopping_receipt,即“购物小票”时,由于此类型仅支持检测分类,无法识别具体票据内容。识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
words_result | 是 | object{} | 识别结果 |
+ probability | 是 | string | 表示单张票据分类的置信度 |
+ left | 是 | string | 表示单张票据定位位置的长方形左上顶点的水平坐标 |
+ top | 是 | string | 表示单张票据定位位置的长方形左上顶点的垂直坐标 |
+ width | 是 | string | 表示单张票据定位位置的长方形的宽度 |
+ height | 是 | string | 表示单张票据定位位置的长方形的高度 |
+ type | 是 | string | shopping_receipt |
返回说明-POS小票
type 的返回结果为 pos_invoice,即“POS小票”时,由于此类型仅支持检测分类,无法识别具体票据内容。识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
words_result | 是 | object{} | 识别结果 |
+ probability | 是 | string | 表示单张票据分类的置信度 |
+ left | 是 | string | 表示单张票据定位位置的长方形左上顶点的水平坐标 |
+ top | 是 | string | 表示单张票据定位位置的长方形左上顶点的垂直坐标 |
+ width | 是 | string | 表示单张票据定位位置的长方形的宽度 |
+ height | 是 | string | 表示单张票据定位位置的长方形的高度 |
+ type | 是 | string | pos_invoice |
返回说明-其他
type 的返回结果为 others,即“其他”时,由于此类型仅支持检测分类,无法识别具体票据内容。识别结果的返回字段如下
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
words_result | 是 | object{} | 识别结果 |
+ probability | 是 | string | 表示单张票据分类的置信度 |
+ left | 是 | string | 表示单张票据定位位置的长方形左上顶点的水平坐标 |
+ top | 是 | string | 表示单张票据定位位置的长方形左上顶点的垂直坐标 |
+ width | 是 | string | 表示单张票据定位位置的长方形的宽度 |
+ height | 是 | string | 表示单张票据定位位置的长方形的高度 |
+ type | 是 | string | others |
返回说明-验真参数开启
当验真参数开启(即 verify_parameter=true 时),返回匹配发票验真接口所需的6要素信息
字段 | 是否必选 | 类型 | 说明 |
---|---|---|---|
++ invoice_code | 是 | array[] | 发票代码 |
++ invoice_num | 是 | array[] | 发票号码 |
++ invoice_date | 是 | array[] | 开票日期。返回格式为 YYYYMMDD,例:20210101 |
++ invoice_type | 是 | array[] | 发票种类。不同类型发票输出如下结果:增值税专用发票:special_vat_invoice增值税电子专票:elec_special_vat_invoice增值税普通发票:normal_invoice增值税普通发票(电子):elec_normal_invoice增值税普通发票(卷式):roll_normal_invoice全电发票(专用发票):elec_invoice_special全电发票(普通发票):elec_invoice_normal通行费增值税电子普通发票:toll_elec_normal_invoice货运运输业增值税专用发票:special_freight_transport_invoice机动车销售发票:motor_vehicle_invoice二手车销售发票:used_vehicle_invoice区块链发票:blockchain_invoice通用机打电子发票:printed_elec_invoice电子发票(铁路电子客票):elec_train_ticket_invoice电子发票(航空运输电子客票行程单):elec_flight_itinerary_invoice |
++ total_amount | 是 | array[] | 不含税金额 |
++ check_code | 否 | array[] | 检验码。如需使用百度的增值税发票验真接口,需提取返回值的后6位后,再传入验真接口 |
返回示例
1{
2 "words_result": [
3 {
4 "type": "vat_invoice",
5 "width": 0,
6 "probability": 0.9980429411,
7 "height": 649,
8 "left": 154,
9 "top": 177,
10 "result": {
11 "AmountInWords": [
12 {
13 "word": "叁佰陆拾圆整"
14 }
15 ],
16 "InvoiceNumConfirm": [
17 {
18 "word": "07286261"
19 }
20 ],
21 "CommodityEndDate": [],
22 "CommodityVehicleType": [],
23 "CommodityStartDate": [],
24 "CommodityPrice": [
25 {
26 "row": "1",
27 "word": "339.62"
28 }
29 ],
30 "NoteDrawer": [
31 {
32 "word": "余佳燕"
33 }
34 ],
35 "SellerAddress": [],
36 "CommodityNum": [
37 {
38 "row": "1",
39 "word": "1"
40 }
41 ],
42 "SellerRegisterNum": [
43 {
44 "word": "91330106673959654P"
45 }
46 ],
47 "MachineCode": [],
48 "Remarks": [],
49 "SellerBank": [
50 {
51 "word": "招商银行杭州高新支行502905023610702"
52 }
53 ],
54 "CommodityTaxRate": [
55 {
56 "row": "1",
57 "word": "6%"
58 }
59 ],
60 "TotalTax": [
61 {
62 "word": "20.38"
63 }
64 ],
65 "InvoiceCodeConfirm": [
66 {
67 "word": "3321192130"
68 }
69 ],
70 "CheckCode": [],
71 "InvoiceCode": [
72 {
73 "word": "3321192130"
74 }
75 ],
76 "InvoiceDate": [
77 {
78 "word": "2019年08月28日"
79 }
80 ],
81 "PurchaserRegisterNum": [
82 {
83 "word": "91110911717743469K"
84 }
85 ],
86 "InvoiceTypeOrg": [
87 {
88 "word": "浙江增值税专用发票"
89 }
90 ],
91 "OnlinePay": [],
92 "Password": [
93 {
94 "word": "508>3909>1*>01/-46709-6/3+*7+8>/1*19+7-0**>+58290-6>647-+324865*9*1<*2191/7754/<0>2<838+//5-69--748*<251408<"
95 }
96 ],
97 "Agent": [
98 {
99 "word": "否"
100 }
101 ],
102 "AmountInFiguers": [
103 {
104 "word": "360.00"
105 }
106 ],
107 "PurchaserBank": [
108 {
109 "word": "招商银行北京分行大电路支行866180100210002"
110 }
111 ],
112 "Checker": [
113 {
114 "word": "柳余"
115 }
116 ],
117 "City": [],
118 "TotalAmount": [
119 {
120 "word": "339.62"
121 }
122 ],
123 "CommodityAmount": [
124 {
125 "row": "1",
126 "word": "339.62"
127 }
128 ],
129 "PurchaserName": [
130 {
131 "word": "百度在线网络技术(北京)有限公司"
132 }
133 ],
134 "CommodityType": [],
135 "Province": [
136 {
137 "word": "浙江"
138 }
139 ],
140 "InvoiceType": [
141 {
142 "word": "专用发票"
143 }
144 ],
145 "SheetNum": [
146 {
147 "word": "第二联:抵扣联"
148 }
149 ],
150 "PurchaserAddress": [],
151 "CommodityTax": [
152 {
153 "row": "1",
154 "word": "20.38"
155 }
156 ],
157 "CommodityPlateNum": [],
158 "CommodityUnit": [
159 {
160 "row": "1",
161 "word": "套"
162 }
163 ],
164 "Payee": [
165 {
166 "word": "佳机"
167 }
168 ],
169 "CommodityName": [
170 {
171 "row": "1",
172 "word": "*信息技术服务*软件服务费"
173 }
174 ],
175 "SellerName": [
176 {
177 "word": "百度智能云"
178 }
179 ],
180 "InvoiceNum": [
181 {
182 "word": "07286261"
183 }
184 ]
185 }
186 },
187 {
188 "type": "taxi_receipt",
189 "width": 0,
190 "probability": 0.9858493805,
191 "height": 615,
192 "left": 1325,
193 "top": 200,
194 "result": {
195 "PickupTime": [
196 {
197 "word": "10:50"
198 }
199 ],
200 "DropoffTime": [
201 {
202 "word": "17:06"
203 }
204 ],
205 "Time": [
206 {
207 "word": "10:50-17:06"
208 }
209 ],
210 "City": [
211 {
212 "word": ""
213 }
214 ],
215 "FuelOilSurcharge": [
216 {
217 "word": "1.00"
218 }
219 ],
220 "Date": [
221 {
222 "word": "2019-03-20"
223 }
224 ],
225 "Province": [
226 {
227 "word": "陕西省"
228 }
229 ],
230 "CallServiceSurcharge": [
231 {
232 "word": "0.00"
233 }
234 ],
235 "Fare": [
236 {
237 "word": "21.10"
238 }
239 ],
240 "TotalFare": [
241 {
242 "word": "22.00"
243 }
244 ],
245 "TaxiNum": [
246 {
247 "word": "AQ6353"
248 }
249 ],
250 "PricePerkm": [
251 {
252 "word": "2.30"
253 }
254 ],
255 "InvoiceCode": [
256 {
257 "word": "161001881016"
258 }
259 ],
260 "Distance": [
261 {
262 "word": "6.0"
263 }
264 ],
265 "InvoiceNum": [
266 {
267 "word": "05070716"
268 }
269 ],
270 "Location": [
271 {
272 "word": "陕西省"
273 }
274 ]
275 }
276 }
277 ],
278 "words_result_num": 2,
279 "log_id": 1438382953545048984
280}