智能财务票据识别
接口描述
支持财务场景中13种常见票据的分类及结构化识别,包括增值税发票、卷票、机打发票、定额发票、火车票、出租车票、网约车行程单、飞机行程单、汽车票、过路过桥费、船票、机动车/二手车销售发票。支持多张不同种类票据在同一张图片上的混贴场景,可返回每张票据的位置、种类及票面信息的结构化识别结果。
视频教程请参见 智能财务票据识别+增值税发票验真使用教程
在线调试
您可以在 示例代码中心中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求URL: https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice
URL参数:
Header如下:
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编码后大小不超过8M,最短边至少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后大小不超过8M,最短边至少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后大小不超过8M,最短边至少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信息。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
curl -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'
# encoding:utf-8
import requestsimport base64'''
智能财务票据识别
'''
request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice"
# 二进制方式打开图片文件
f = open('[本地文件]', 'rb')
img = base64.b64encode(f.read())
params = {"image":img}
access_token = '[调用鉴权接口获取的token]'
request_url = request_url + "?access_token=" + access_token
headers = {'content-type': 'application/x-www-form-urlencoded'}
response = requests.post(request_url, data=params, headers=headers)
if response:
print (response.json())
package com.baidu.ai.aip;
import com.baidu.ai.aip.utils.Base64Util;
import com.baidu.ai.aip.utils.FileUtil;
import com.baidu.ai.aip.utils.HttpUtil;
import java.net.URLEncoder;
/**
* 智能财务票据识别
*/
public class MultipleInvoice {
/**
* 重要提示代码中所需工具类
* FileUtil,Base64Util,HttpUtil,GsonUtils请从
* https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72
* https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2
* https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3
* https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3
* 下载
*/
public static String multipleInvoice() {
// 请求url
String url = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice";
try {
// 本地文件路径
String filePath = "[本地文件路径]";
byte[] imgData = FileUtil.readFileByBytes(filePath);
String imgStr = Base64Util.encode(imgData);
String imgParam = URLEncoder.encode(imgStr, "UTF-8");
String param = "image=" + imgParam;
// 注意这里仅为了简化编码每一次请求都去获取access_token,线上环境access_token有过期时间, 客户端可自行缓存,过期后重新获取。
String accessToken = "[调用鉴权接口获取的token]";
String result = HttpUtil.post(url, accessToken, param);
System.out.println(result);
return result;
} catch (Exception e) {
e.printStackTrace();
}
return null;
}
public static void main(String[] args) {
MultipleInvoice.multipleInvoice();
}
}
#include <iostream>
#include <curl/curl.h>
// libcurl库下载链接:https://curl.haxx.se/download.html
// jsoncpp库下载链接:https://github.com/open-source-parsers/jsoncpp/
const static std::string request_url = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice";
static std::string multipleInvoice_result;
/**
* curl发送http请求调用的回调函数,回调函数中对返回的json格式的body进行了解析,解析结果储存在全局的静态变量当中
* @param 参数定义见libcurl文档
* @return 返回值定义见libcurl文档
*/
static size_t callback(void *ptr, size_t size, size_t nmemb, void *stream) {
// 获取到的body存放在ptr中,先将其转换为string格式
multipleInvoice_result = std::string((char *) ptr, size * nmemb);
return size * nmemb;
}
/**
* 智能财务票据识别
* @return 调用成功返回0,发生错误返回其他错误码
*/
int multipleInvoice(std::string &json_result, const std::string &access_token) {
std::string url = request_url + "?access_token=" + access_token;
CURL *curl = NULL;
CURLcode result_code;
int is_success;
curl = curl_easy_init();
if (curl) {
curl_easy_setopt(curl, CURLOPT_URL, url.data());
curl_easy_setopt(curl, CURLOPT_POST, 1);
curl_httppost *post = NULL;
curl_httppost *last = NULL;
curl_formadd(&post, &last, CURLFORM_COPYNAME, "image", CURLFORM_COPYCONTENTS, "【base64_img】", CURLFORM_END);
curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, callback);
result_code = curl_easy_perform(curl);
if (result_code != CURLE_OK) {
fprintf(stderr, "curl_easy_perform() failed: %s\n",
curl_easy_strerror(result_code));
is_success = 1;
return is_success;
}
json_result = multipleInvoice_result;
curl_easy_cleanup(curl);
is_success = 0;
} else {
fprintf(stderr, "curl_easy_init() failed.");
is_success = 1;
}
return is_success;
}
<?php
/**
* 发起http post请求(REST API), 并获取REST请求的结果
* @param string $url
* @param string $param
* @return - http response body if succeeds, else false.
*/
function request_post($url = '', $param = '')
{
if (empty($url) || empty($param)) {
return false;
}
$postUrl = $url;
$curlPost = $param;
// 初始化curl
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $postUrl);
curl_setopt($curl, CURLOPT_HEADER, 0);
// 要求结果为字符串且输出到屏幕上
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
// post提交方式
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);
// 运行curl
$data = curl_exec($curl);
curl_close($curl);
return $data;
}
$token = '[调用鉴权接口获取的token]';
$url = 'https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice?access_token=' . $token;
$img = file_get_contents('[本地文件路径]');
$img = base64_encode($img);
$bodys = array(
'image' => $img
);
$res = request_post($url, $bodys);
var_dump($res);
using System;
using System.IO;
using System.Net;
using System.Text;
using System.Web;
namespace com.baidu.ai{
public class MultipleInvoice
{
// 智能财务票据识别
public static string multipleInvoice()
{
string token = "[调用鉴权接口获取的token]";
string host = "https://aip.baidubce.com/rest/2.0/ocr/v1/multiple_invoice?access_token=" + token;
Encoding encoding = Encoding.Default;
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);
request.Method = "post";
request.KeepAlive = true;
// 图片的base64编码
string base64 = getFileBase64("[本地图片文件]");
String str = "image=" + HttpUtility.UrlEncode(base64);
byte[] buffer = encoding.GetBytes(str);
request.ContentLength = buffer.Length;
request.GetRequestStream().Write(buffer, 0, buffer.Length);
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);
string result = reader.ReadToEnd();
Console.WriteLine("智能财务票据识别:");
Console.WriteLine(result);
return result;
}
public static String getFileBase64(String fileName) {
FileStream filestream = new FileStream(fileName, FileMode.Open);
byte[] arr = new byte[filestream.Length];
filestream.Read(arr, 0, (int)filestream.Length);
string baser64 = Convert.ToBase64String(arr);
filestream.Close();
return baser64;
}
}
}
返回说明
返回参数
字段 |
是否必选 |
类型 |
说明 |
---|---|---|---|
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,即“增值税发票”时,识别结果的返回字段如下
字段 |
是否必选 |
类型 |
说明 |
---|---|---|---|
++ 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[] |
通行日期止。仅通行费增值税电子普通发票含有此参数 |
+++ 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[] |
电子客票号,仅在输入为电子火车票时返回该字段 |
+++ 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[] |
有效期截止日期 |
+++ 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
|
++ total_amount |
是 |
array[] |
不含税金额 |
++ check_code |
否 |
array[] |
检验码。如需使用百度的增值税发票验真接口,需提取返回值的后6位后,再传入验真接口
|
返回示例
{
"words_result": [
{
"type": "vat_invoice",
"width": 0,
"probability": 0.9980429411,
"height": 649,
"left": 154,
"top": 177,
"result": {
"AmountInWords": [
{
"word": "叁佰陆拾圆整"
}
],
"InvoiceNumConfirm": [
{
"word": "07286261"
}
],
"CommodityEndDate": [],
"CommodityVehicleType": [],
"CommodityStartDate": [],
"CommodityPrice": [
{
"row": "1",
"word": "339.62"
}
],
"NoteDrawer": [
{
"word": "余佳燕"
}
],
"SellerAddress": [],
"CommodityNum": [
{
"row": "1",
"word": "1"
}
],
"SellerRegisterNum": [
{
"word": "91330106673959654P"
}
],
"MachineCode": [],
"Remarks": [],
"SellerBank": [
{
"word": "招商银行杭州高新支行502905023610702"
}
],
"CommodityTaxRate": [
{
"row": "1",
"word": "6%"
}
],
"TotalTax": [
{
"word": "20.38"
}
],
"InvoiceCodeConfirm": [
{
"word": "3321192130"
}
],
"CheckCode": [],
"InvoiceCode": [
{
"word": "3321192130"
}
],
"InvoiceDate": [
{
"word": "2019年08月28日"
}
],
"PurchaserRegisterNum": [
{
"word": "91110911717743469K"
}
],
"InvoiceTypeOrg": [
{
"word": "浙江增值税专用发票"
}
],
"OnlinePay": [],
"Password": [
{
"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<"
}
],
"Agent": [
{
"word": "否"
}
],
"AmountInFiguers": [
{
"word": "360.00"
}
],
"PurchaserBank": [
{
"word": "招商银行北京分行大电路支行866180100210002"
}
],
"Checker": [
{
"word": "柳余"
}
],
"City": [],
"TotalAmount": [
{
"word": "339.62"
}
],
"CommodityAmount": [
{
"row": "1",
"word": "339.62"
}
],
"PurchaserName": [
{
"word": "百度在线网络技术(北京)有限公司"
}
],
"CommodityType": [],
"Province": [
{
"word": "浙江"
}
],
"InvoiceType": [
{
"word": "专用发票"
}
],
"SheetNum": [
{
"word": "第二联:抵扣联"
}
],
"PurchaserAddress": [],
"CommodityTax": [
{
"row": "1",
"word": "20.38"
}
],
"CommodityPlateNum": [],
"CommodityUnit": [
{
"row": "1",
"word": "套"
}
],
"Payee": [
{
"word": "佳机"
}
],
"CommodityName": [
{
"row": "1",
"word": "*信息技术服务*软件服务费"
}
],
"SellerName": [
{
"word": "百度智能云"
}
],
"InvoiceNum": [
{
"word": "07286261"
}
]
}
},
{
"type": "taxi_receipt",
"width": 0,
"probability": 0.9858493805,
"height": 615,
"left": 1325,
"top": 200,
"result": {
"PickupTime": [
{
"word": "10:50"
}
],
"DropoffTime": [
{
"word": "17:06"
}
],
"Time": [
{
"word": "10:50-17:06"
}
],
"City": [
{
"word": ""
}
],
"FuelOilSurcharge": [
{
"word": "1.00"
}
],
"Date": [
{
"word": "2019-03-20"
}
],
"Province": [
{
"word": "陕西省"
}
],
"CallServiceSurcharge": [
{
"word": "0.00"
}
],
"Fare": [
{
"word": "21.10"
}
],
"TotalFare": [
{
"word": "22.00"
}
],
"TaxiNum": [
{
"word": "AQ6353"
}
],
"PricePerkm": [
{
"word": "2.30"
}
],
"InvoiceCode": [
{
"word": "161001881016"
}
],
"Distance": [
{
"word": "6.0"
}
],
"InvoiceNum": [
{
"word": "05070716"
}
],
"Location": [
{
"word": "陕西省"
}
]
}
}
],
"words_result_num": 2,
"log_id": 1438382953545048984
}
鼠标选取文档内容,精确反馈问题
选取您有疑问的文档内容,即可更精确地反馈问题,我们将会跟进处理。