服务端 API 文档

文档捉虫大赛火热进行中,好礼多多> HOT

使用说明

增值税发票类

业务分类 分类依据 发票核验
1级 2级 1级 2级 是否支持 Type
增值税发票 纸质专票 Type:3 发票类型为“纸质专票” 01
电子专票 Type:3 发票类型为“电子专票” 01
纸质普票 Type:3 发票类型为“增值税普通发票” 04
电子普票 Type:3 发票类型为“增值税电子普通发票” 04
区块链发票 Type:3 发票类型为“区块链发票” 32
通行费发票 Type:3 发票类型为“电子普通发票(通行费)” 14
卷票 Type:11 发票类型为“增值税发票(卷票)” 11
购车发票 购车发票 Type:12 发票类型为“购车发票” 03
二手车发票 Type:12 发票类型为“二手车销售统一发票” 15
全电发票 专用发票 Type:16 发票名称为“电子发票(增值税专用发票)” 08
普通发票 Type:16 发票名称为“电子发票(增值税普通发票)” 10

非增值税发票类

业务分类 分类依据 发票核验
1级 2级 1级 2级 是否支持
出租车发票 - Type:0 -
定额发票 - Type:1 -
火车票 - Type:2 -
机票行程单 - Type:5 -
通用机打发票 - Type:8 -
汽车票 - Type:9 -
轮船票 - Type:10 -
过路过桥费发票 - Type:13 -
非税发票 - Type:15 -
其他发票 - Type:-1 -

返回参数说明

名称 类型 描述
Name String 识别出的字段名称(关键字),支持以下描述字段
Value String 识别出的字段名称对应的值,也就是字段Name对应的字符串结果。字段内容可能返回 null,表示取不到有效值。
Rect Rect 文本行在旋转纠正之后的图像中的像素坐标。
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

0:出租车发票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 出租车发票
发票代码 String 发票代码 122052222222
发票号码 String 发票号码 80001000
日期 String 开票日期 2022年06月07日
金额 String 小写金额 20.00
上车时间 String 上车时间 08:27
下车时间 String 下车时间 09:02
里程 String 里程 33.0
发票所在地 String 票面显示地区 深圳市
车牌号 String 票面打印车牌号 A00000
发票消费类型 String 发票消费类型 交通
String 开票省 广东省
String 开票市 深圳市

1:定额发票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 定额发票
发票号码 String 发票号码 80001000
发票代码 String 发票代码 122052222222
大写金额 String 大写金额
小写金额 String 小写金额 20.00
发票消费类型 String 发票消费类型 交通
String 开票省 广东省
String 开票市 深圳市
是否有公司印章 String 1有 0无 空为识别不出 1

2:火车票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 火车票
编号 String 火车票左上角红色编号 000B082555
出发站 String 出发站 深圳
到达站 String 到达站 广州
售票站 String 售票站 深圳
出发时间 String 出发时间 2022年06月01日14:26
车次 String 火车车次 D3066
座位号 String 乘坐座位号 09车002号上铺
姓名 String 票面姓名 张三
身份证号 String 票面身份证号 4112212022****0099
票价 String 票价 20.00
大写金额 String 大写金额 贰拾圆整
席别 String 乘坐席别 新空调硬卧
发票消费类型 String 发票消费类型 交通
序列号 String 下方发票序列号 33331300301000B082555
加收票价 String 加收票价 20.00
手续费 String 手续费 20.00
仅供报销使用 String 检测是否有“仅供报销使用”字样,1表示有,0表示无 1

3:增值税发票

识别出的字段名称(关键字),支持以下字段。对接发票核验接口的字段,已做加粗显示。

Name 类型 描述 示例
发票类型 String 发票子类型 增值税专用发票
发票名称 String 票面实际发票名称 广东增值税专用发票
是否有公司印章 String 检测发票是否存在公章,1表示有,0表示无 1
发票代码 String 发票代码,12位。 122052222222
发票号码 String 发票号码,含No,8位数字。 No80001000
开票日期 String 开票日期 2022年06月07日
校验码 String 校验码,20位。 区块链为5位。 79294846666888030000
打印发票代码 String 右侧打印发票代码,可作为备选 122052222222
打印发票号码 String 右侧打印发票号码,含No字样,可作为补充备选 No80001000
销售方名称 String 销售方名称 深圳市腾讯计算机系统有限公司
购买方名称 String 购买方名称 深圳市腾讯计算机系统有限公司
购买方识别号 String 购买方识别号 9144030071526726XG
销售方识别号 String 销售方识别号 9144030071526726XG
密码区1 String 密码区第一行 8<0000000-1/<33333>><<+0*80
密码区2 String 密码区第二行 8<0000000-1/<33333>><<+0*80
密码区3 String 密码区第三行 8<0000000-1/<33333>><<+0*80
密码区4 String 密码区第四行 8<0000000-1/<33333>><<+0*80
税额 String 小写税额 50.00
税率 String 税率 13%
联次名称 String 联次名称,8月上线 发票联
合计金额 String 不含税合计金额,带金额符号 ¥357.52
合计税额 String 小写合计税额 46.48
价税合计(大写) String 价税合计(大写) 肆佰零肆圆整
小写金额 String 价税合计小写金额 ¥404.00
开票人 String 下方开票人名称 张三
收款人 String 下方收款人名称 张三
复核 String 下方复核人名称 张三
销货单位名称 String 销货单位名称
联次 String 联次
联次名称 String 联次名称 发票联
发票消费类型 String 发票消费类型
服务类型 String 服务类型
校验码备选 String 校验码备选
校验码后六位备选 String 校验码后六位备选 666000
发票号码备选 String 发票号码备选
成品油标志 String 是否有成品油标志 1
通行费标志 String 是否有通行费标志 1
是否代开 String 是否有代开标识 0
是否收购 String 是否有收购标识 0
String 开票省 广东省
String 开票市 深圳市
通行日期起 String 起始通行日期
通行日期止 String 终止通行日期
类型 String 类型
车牌号 String 车牌号
规格型号 String 规格型号
单价 String 物品明细小写单价 7.92024812
金额 String 物品金额 357.52
数量 String 数量 45.14
单位 String 单位
备注 String 备注
车船税 String 车船税
机器编号 String 机器编号
货物或应税劳务、服务名称 String 明细栏货物或应税劳务、服务名称 *现代服务*服务费
购买方开户行及账号 String 购买方开户行及账号 中国工商银行深圳市XXX支行1302010000000000088
销售方开户行及账号 String 销售方开户行及账号 中国工商银行深圳市XXX支行1302010000000000088

5:机票行程单

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 机票行程单
发票名称 String 票面实际发票名称 航空运输电子客票行程单
印刷序号 String 右上方印刷序号 53700088888
票价 String 小写票价 800.00
合计金额 String 合计金额 200.00
填开日期 String 填开日期 2022年06月20日
有效身份证件号码 String 有效身份证件号码 411000202201018888
电子客票号码 String 电子客票号码
验证码 String 验证码 6668
旅客姓名 String 旅客姓名 张三
填开单位 String 填开单位
其他税费 String 其他税费 0.00
燃油附加费 String 燃油附加费 50.00
民航发展基金 String 民航发展基金 50.00
保险费 String 保险费
销售单位代号 String 销售单位代号
始发地 String 始发地 太原-武宿
目的地 String 目的地 长春-龙嘉
航班号 String 航班号 SC8855
时间 String 乘坐时间 12:20
日期 String 乘坐日期,格式为XXXX年XX月XX日。 2022年06月19日
座位等级 String 座位等级 G
承运人 String 承运人 山航
发票消费类型 String 发票消费类型 交通
国内国际标签 String 国内国际标签
客票级别/类别 String 客票级别/类别 5
客票生效日期 String 客票生效日期
有效期截止日期 String 有效期截止日期
免费行李 String 免费行李重量 20K

8:通用机打发票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 通用机打发票
发票名称 String 票面实际发票名称 广东通用机打发票
发票代码 String 发票代码 122052222222
发票号码 String 发票号码 80001000
日期 String 日期 2022年03月06日
合计金额(小写) String 合计金额(小写) 20.00
合计金额(大写) String 合计金额(大写) 贰拾圆整
校验码 String 校验码
购买方名称 String 购买方名称 深圳市腾讯计算机系统有限公司
销售方名称 String 销售方名称 深圳市腾讯计算机系统有限公司
购买方识别号 String 购买方纳税人识别号 9144030071526726XG
销售方识别号 String 销售方纳税人识别号 9144030071526726XG
密码区 String
时间 String 时间
种类 String 种类
发票消费类型 String 发票消费类型
String
String
是否有公司印章 String 是否有公司印章
发票名称 String 发票名称
购买方地址、电话 String 为同一字段
销售方地址、电话 String 为同一字段
购买方开户行及账号 String 购买方开户行及账号
销售方开户行及账号 String 销售方开户行及账号
经办人取票用户 String 经办人取票用户
经办人支付信息 String 经办人支付信息
经办人商户号 String 经办人商户号
经办人订单号 String 经办人订单号
货物或应税劳务、服务名称 String 为同一字段
数量 String 物品明细数量
单价 String 物品明细单价
税率 String 物品明细税率
税额 String 物品明细税额
金额 String 物品明细金额
单位 String 物品明细单位
规格型号 String 物品明细规格型号
合计税额 String 合计税额
合计金额 String 合计金额
备注 String 备注
收款人 String 收款人名称 张三
复核 String 复核人名称 张三
开票人 String 开票人名称 张三
行业分类 String 行业分类 商业

9:汽车票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 机票行程单
发票名称 String 票面实际发票名称
发票号码 String 发票号码
开票日期 String 开票日期
日期 String 日期
票价 String 票价
始发地 String 始发地
目的地 String 目的地
姓名 String 姓名
时间 String 时间
发票消费类型 String 发票消费类型
身份证号 String 身份证号
String
String
乘车地点 String 乘车地点
检票口 String 检票口
客票类型 String 客票类型
车型 String 车型
座位号 String 座位号
车次 String 车次

10:轮船票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 轮船票
发票名称 String 票面实际发票名称
发票代码 String 发票号码
日期 String 开票日期
票价 String 票价
始发地 String 始发地
目的地 String 目的地
姓名 String 姓名
时间 String 时间
发票消费类型 String 发票消费类型
String
String
币种 String 币种

11:增值税发票(卷票)

识别出的字段名称(关键字),支持以下字段。对接发票核验接口的字段,已做加粗显示。

Name 类型 描述 示例
发票类型 String 发票子类型 增值税发票(卷票 )
发票名称 String 实际票面发票名称 湖北增值税发票(卷票 )
发票代码 String 发票代码 042001000100
发票号码 String 发票号码 33386711
机打号码 String 机打号码 33386711
校验码 String 发票校验码 48762222223914855555
是否有公司印章 String 检测发票是否存在公章,1表示有,0表示无 1
合计金额(大写) String 大写价税合计金额 伍仟叁佰贰拾圆整
价税合计(小写) String 小写价税合计金额 5320.00
不含税价(小写) String 小写不含税金额 5320.00
开票日期 String 开票日期,由于格式多样,统一规整为 XXXX年XX月XX日 2022年06月01日
销售方名称 String 销售方名称 深圳市腾讯计算机系统有限公司
购买方名称 String 购买方名称 深圳市腾讯计算机系统有限公司
身份证号码/组织机构代码 String 身份证号码/组织机构代码
购买方识别号 String 购买方纳税人识别号 9144030071526726XG
销售方识别号 String 销售方纳税人识别号 9144030071526726XG
发票消费类型 String 发票消费类型 服务
String 开票省 广东省
String 开票市 深圳市
品名 String 开票物品名称 *化学药品制剂*布洛芬片
种类 String 种类 其他
服务类型 String 服务类型 其他

12:购车发票

识别出的字段名称(关键字),支持以下字段。对接发票核验接口的字段,已做加粗显示。

Name 类型 描述 示例
发票类型 String 发票子类型 二手车销售统一发票
发票名称 String 发票票面实际名称 二手车销售统一发票
二维码 String 检测发票是否存在二维码,1表示有,0表示无 1
发票代码 String 机打代码 122052222222
发票号码 String 机打号码 80001000
开票日期 String 开票日期,格式为XXXX-XX-XX,符合核验入参格式。 2022-06-20
机打代码 String 机打代码 122052222222
机打号码 String 机打号码 80001000
发动机号码 String 发动机号码
合格证号 String 合格证号
增值税税额 String 增值税税额 ¥15634.51
价税合计(小写) String 价税合计(小写)
不含税价(小写) String 不含税价(小写) ¥1120265.49
价税合计 String 价税合计
销货单位名称 String 销货单位名称
身份证号码/组织机构代码 String 身份证号码/组织机构代码
购买方名称 String 购买方名称
购买方纳税人识别号 String 购买方纳税人识别号 9144030071526726XG
销售方纳税人识别号 String 销售方纳税人识别号 9144030071526726XG
主管税务机关 String 主管税务机关
主管税务机关代码 String 主管税务机关代码
发票消费类型 String 发票消费类型 用车
增值税税率或征收率 String 增值税税率或征收率
String 开票省 湖北省
String 开票市 武汉市
开票人 String 开票人名称 张三
备注 String 开票备注 一车一票
车辆识别代号/车架号码 String 车辆VIN码,17位 LSJA00A00AA100001
车辆类型 String 车辆类型 多用途乘用车
吨位 String 吨位
销售方开户银行 String 销售方开户银行
销售方地址 String 销售方地址
商检单号 String 商检单号
厂牌型号 String 厂牌型号
销售方电话 String 销售方电话
限乘人数 String 限乘人数
销售方账号 String 销售方账号
产地 String 产地
进口证明书号 String 进口证明书号
机器编号 String 机器编号
转入地车辆管理所名称 String 转入地车辆管理所名称
二手车市场 String 二手车市场
二手车市场纳税人识别号 String 二手车市场纳税人识别号
二手车市场地址 String 二手车市场地址
二手车市场开户银行、账号 String 二手车市场开户银行、账号
二手车市场电话 String 二手车市场电话

13:过路过桥费发票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 过路过桥费发票
发票名称 String 发票票面实际名称 深圳市广深沿江高速公路投资有限公司通用机打发票
发票代码 String 发票代码 144031700221
发票号码 String 发票号码 27357827
日期 String 日期 2018年08月07日
金额 String 金额 5.00
入口 String 入口 前海
出口 String 出口 大铲湾
时间 String 时间 06:14:03
发票消费类型 String 发票消费类型 交通
高速标志 String 是否存在高速标志,1表示有 0表示无 1

15:非税发票

识别出的字段名称(关键字),支持以下字段。本票种暂不支持核验。

Name 类型 描述 示例
发票类型 String 发票子类型 过路过桥费发票
发票名称 String 发票票面实际名称
票据代码 String 票据代码
票据号码 String 票据号码
校验码 String 校验码
开票日期 String 开票日期
金额合计大写 String 金额合计大写
金额合计小写 String 金额合计小写
交款人统一社会信用代码 String 交款人统一社会信用代码
交款人 String 交款人
项目编码 String 项目编码
项目名称 String 项目名称
单位 String 单位
数量 String 数量
标准 String 标准
金额 String 金额
备注 String 备注
收款单位 String 收款单位
收款人 String 收款人
复核人 String 复核人
其他信息 String 其他信息

16:全电发票

识别出的字段名称(关键字),支持以下字段。对接发票核验接口的字段,做加粗显示。

Name 类型 描述 示例
发票类型 String 发票子类型 全电发票
发票名称 String 发票票面实际名称 电子发票(增值税专用发票)
发票号码 String 发票号码,20位。 2244100000000000033312
开票日期 String 开票日期 2022年06月01日
合计金额 String 合计金额
合计税额 String 合计税额
价税合计(大写) String 大写价税合计 贰拾圆整
价税合计(小写) String 小写价税合计 20.00
购买方名称 String 购买方名称
购买方识别号 String 购买方识别号
销售方名称 String 销售方名称
销售方识别号 String 销售方识别号
开票人 String 开票人
备注 String 备注

-1:其他发票

识别出的字段名称(关键字),支持以下字段:

Name 类型 描述 示例
发票类型 String 发票子类型 其他发票
发票名称 String 发票票面实际名称
标题 String 发票标题
票面字段 String 智能识别票面中存在的字段

截图示例代码

java 示例代码

public static Mat warp(RotatedRect rect, Mat sourceImage) {
    double angle = rect.angle;
    double sinA = Math.sin(angle);
    double cosA = Math.cos(angle);
    Mat m = new Mat(2,3,CvType.CV_32FC1);
    m.put(0,0,cosA, sinA, rect.size.width/2.0 - cosA * rect.center.x - sinA * rect.center.y);
    m.put(1, 0, -sinA, cosA, rect.size.height/2.0 - cosA * rect.center.y + sinA * rect.center.x);
    Mat targetImage = new Mat();
    sourceImage.copyTo(targetImage);
    Imgproc.warpAffine(targetImage, targetImage, m, rect.size, Imgproc.INTER_LINEAR);
    return targetImage;
}

c++ 示例代码

    cv::RotatedRect r_rect = cv::minAreaRect(points);

   float angle = r_rect.angle * M_PI / 180.0;
   float sinA = sin(angle), cosA = cos(angle);
   float data[6] = {
       cosA, sinA, r_rect.size.width/2.0f - cosA * r_rect.center.x - sinA * r_rect.center.y,
       -sinA, cosA, r_rect.size.height/2.0f - cosA * r_rect.center.y + sinA * r_rect.center.x};
   cv::Mat M(2, 3, CV_32FC1, data);

   cv::warpAffine(res.process_image, res.process_image, M, r_rect.size, cv::INTER_LINEAR);

目录