智能多媒体服务 >
API 文档 >
票证自动识别(OCR) >
单张发票识别 OCR
单张发票识别 OCR
最近更新时间: 2022-05-18 11:30:39
接口简介
本接口可准确高效识别各类国内,国际发票,并结构化输出各类发票关键字段,支持识别单张发票,可无缝对接财务、工商、保险、企事业单位、政府等多个行业的业务流程,辅助办公人员便捷、快速、准确地采集各类票据的票面信息,高效提升财务管理效率。
注意
- 支持的图片类型: jpg, jpeg, png
- 图片最大支持8M
- 支持识别发票类型的见下方发票类型字段说明
- 支持识别一张图片中包含单张发票情况,
请求语法
头部信息
| 头部名称 |
必填 |
说明 |
| Host |
是 |
固定为 ap-gate-z0.qiniuapi.com |
| Authorization |
是 |
该参数应严格按照管理凭证格式进行填充,否则会返回 401 错误码。一个合法的 Authorization 值应类似于:Qiniu QNJi_bYJlmO5LeY08FfoNj9w_r7... |
请求参数
| 字段 |
是否必填 |
类型 |
说明 |
| url |
Y |
string |
待检测图片的url链接 |
返回参数
放在 HTTP Body 中,采用 Json 格式,具体参数如下:
| 字段 |
类型 |
说明 |
| result |
int |
返回码,请求状态. 1:成功, 0:失败 |
| response |
json_object |
识别结果详情 |
| code |
int |
错误码 |
| message |
string |
错误说明 |
| type |
int |
发票类型 |
发票类型字段说明
| 字段枚举 |
描述 |
| 10100 |
增值税专用发票 |
| 10101 |
增值税普通发票 |
| 10102 |
增值税电子普通发票 |
| 10103 |
增值税普通发票(卷票) |
| 10104 |
机动车销售统一发票 |
| 10105 |
二手车销售统一发票 |
| 10505a |
船票 |
| 10200 |
定额发票 |
| 10400 |
机打发票 |
| 10500 |
出租车发票 |
| 10503 |
火车票 |
| 10505 |
客运汽车 |
| 10506 |
航空运输电子客票行程单 |
| 10507 |
过路费发票 |
| 10900 |
可报销其他发票 |
| 20100 |
国际小票 |
| 20105 |
滴滴出行行程单 |
| 10902 |
完税证明 |
增值税发票识别结果字段说明
| 字段枚举 |
描述 |
| orientation |
发票顺时针旋转方向 |
| code |
印刷发票代码 |
| number |
印刷发票号码 |
| date |
开票日期 |
| pretax_amount |
税前金额 |
| total |
总金额 |
| tax |
税额 |
| check_code |
校验码 |
| seller |
销售方名称 |
| seller_tax_id |
销售方纳税人识别号 |
| buyer |
购买方方名称 |
| buyer_tax_id |
购买方纳税人识别号 |
| company_seal |
是否有公司印章(0:没有;1:有) |
| form_type |
发票是第几联 |
| form_name |
发票联次 |
| kind |
发票消费类型 |
| ciphertext |
密码区,四行密码,每行以逗号隔开 |
| transit_mark |
通行费标志 |
| oil_mark |
成品油标志 |
| machine_code |
机器编号 |
| travel_tax |
车船税 |
| receiptor |
收款人 |
| reviewer |
复核 |
| issuer |
开票人 |
| province |
省 |
| city |
市 |
| service_name |
服务类型 |
| remark |
备注 |
| item_names |
品名,每个以逗号隔开 |
| agent_mark |
是否代开 |
| acquisition_mark |
是否收购 |
| block_chain |
区块链标记 |
| code_confirm |
机打发票代码 |
| number_confirm |
机打发票号码 |
出租车发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
发票号码 |
| date |
乘车日期 |
| time_geton |
上车时间 |
| time_getoff |
下车时间 |
| mileage |
里程 |
| total |
总金额 |
| place |
发票所在地 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
| license_plate |
车牌号 |
火车票识别结果字段说明
| 字段枚举 |
描述 |
| number |
号码 |
| date |
乘车日期 |
| time |
乘车时间 |
| name |
乘车人姓名 |
| station_geton |
上车车站 |
| station_getoff |
下车车站 |
| train_number |
车次 |
| seat |
座位类型 |
| total |
总金额 |
| kind |
发票消费类型 |
| serial_number |
序列号 |
| user_id |
身份证号 |
机打发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
号码 |
| date |
日期 |
| time |
时间 |
| check_code |
校验码 |
| category |
种类,oil表示是加油票 |
| total |
总金额 |
| seller |
销售方名称 |
| seller_tax_id |
销售方纳税人识别号 |
| buyer |
购买方方名称 |
| buyer_tax_id |
购买方纳税人识别号 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
| company_seal |
是否有公司印章(0:没有;1:有) |
增值税普通发票 卷票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
号码 |
| date |
日期 |
| check_code |
校验码 |
| seller |
销售方名称 |
| seller_tax_id |
销售方纳税人识别号 |
| buyer |
购买方方名称 |
| buyer_tax_id |
购买方纳税人识别号 |
| category |
种类,oil表示是加油票 |
| total |
总金额 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
| company_seal |
是否有公司印章(0:没有;1:有) |
| service_name |
服务类型 |
| item_names |
品名,每个以逗号隔开 |
定额发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
号码 |
| total |
总金额 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
| company_seal |
是否有公司印章(0:没有;1:有) |
过路费发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
发票号码 |
| date |
日期 |
| time |
时间 |
| entrance |
入口 |
| exit |
出口 |
| total |
总金额 |
| kind |
发票消费类型 |
| highway_flag |
高速标志(0:没有;1:有) |
客运汽车发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
发票号码 |
| date |
日期 |
| time |
时间 |
| station_geton |
出发车站 |
| station_getoff |
达到车站 |
| total |
总金额 |
| name |
姓名 |
| kind |
发票消费类型 |
| user_id |
身份证号 |
航空运输电子客票行程单识别结果字段说明
| 字段枚举 |
描述 |
| user_name |
乘机人姓名 |
| user_id |
身份证号 |
| number |
电子客票号码 |
| check_code |
验证码 |
| date |
填开日期 |
| agentcode |
销售单位代号 |
| issue_by |
填开单位 |
| fare |
票价 |
| tax |
税费 |
| fuel_surcharge |
燃油附加费 |
| caac_development_fund |
民航发展基金 |
| insurance |
保险费 |
| total |
总额 |
| flights |
航班信息 |
| from |
出发站 |
| to |
到达站 |
| flight_number |
航班号 |
| date |
乘机日期 |
| time |
乘机时间 |
| seat |
座位等级 |
| carrier |
承运人 |
| class_name |
舱位等级 |
| from |
出发站 |
| to |
到达站 |
| flight_number |
航班号 |
| date |
乘机日期 |
| time |
乘机时间 |
| seat |
座位等级 |
| carrier |
承运人 |
| class_name |
舱位等级 |
| kind |
发票消费类型 |
| international_flag |
国内国际标签 |
| print_number |
印刷序号 |
二手车销售统一发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
发票号码 |
| date |
开票日期 |
| total |
总金额 |
| seller |
卖方单位/个人 |
| seller_id |
卖方单位代码/个人身份证号 |
| buyer |
买方单位/个人 |
| buyer_id |
买方单位代码/个人身份证号 |
| company_name |
二手车市场 |
| company_tax_id |
二手车市场纳税人识别号 |
| license_plate |
车牌号 |
| registration_number |
登记证号 |
| car_code |
车架号/车辆识别代码 |
| car_model |
厂牌型号 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
机动车销售统一发票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
发票号码 |
| machine_code |
机打代码 |
| machine_number |
机打号码 |
| date |
开票日期 |
| pretax_amount |
税前金额 |
| total |
总金额 |
| seller |
销售单位 |
| seller_tax_id |
销售单位纳税人识别号 |
| buyer |
买方单位/个人 |
| buyer_id |
买方单位代码/个人身份证号 |
| tax_authorities |
主管税务机关 |
| tax_authorities_code |
主管税务机关代码 |
| car_code |
车架号/车辆识别代码 |
| car_engine_code |
发动机号码 |
| car_model |
厂牌型号 |
| certificate_number |
合格证号 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
| tax |
税额 |
| tax_rate |
税率 |
| company_seal |
是否有公司印章(0:没有;1:有) |
小票识别结果字段说明
| 字段枚举 |
描述 |
| store_name |
店名 |
| date |
日期 |
| time |
时间 |
| subtotal |
税前金额 |
| tax |
税费 |
| discount |
折扣 |
| tips |
小费 |
| total |
总金额 |
| currency_code |
币种,使用ISO4217CurrencyCodes标准 |
| type |
消费类型 |
滴滴出行行程单识别结果字段说明
| 字段枚举 |
描述 |
| date |
申请日期 |
| date_start |
行程开始时间 |
| date_end |
行程结束时间 |
| phone |
行程人手机号 |
| total |
总计 |
| items |
行程信息 |
| car_type |
车型 |
| time_geton |
上车时间 |
| city |
城市 |
| station_geton |
起点 |
| station_getoff |
终点 |
| mileage |
里程(公里) |
| total |
金额 |
| car_type |
车型 |
| time_geton |
上车时间 |
| city |
城市 |
| station_geton |
起点 |
| station_getoff |
终点 |
| mileage |
里程(公里) |
| total |
金额 |
| car_type |
车型 |
| time_geton |
上车时间 |
| city |
城市 |
| station_geton |
起点 |
| station_getoff |
终点 |
| mileage |
里程(公里) |
| total |
金额 |
| kind |
发票消费类型 |
完税证明识别结果字段说明
| 字段枚举 |
描述 |
| number |
发票号码 |
| total |
总金额 |
| buyer |
购买方名称 |
| buyer_tax_id |
购买方纳税人识别号 |
| date |
日期 |
| tax_authorities |
主管税务机关 |
船票识别结果字段说明
| 字段枚举 |
描述 |
| code |
发票代码 |
| number |
发票号码 |
| date |
日期 |
| time |
时间 |
| station_geton |
出发车站 |
| station_getoff |
达到车站 |
| total |
总金额 |
| name |
姓名 |
| kind |
发票消费类型 |
| province |
省 |
| city |
市 |
| currency_code |
币种 |
增值税字段说明
| 字段枚举 |
描述 |
| check_code_candidates |
校验码备选 |
| check_code_last_six |
校验码后六位备选 |
| number_order_error |
发票号码备选(如发现可能错号等情况) |
二维码或者条码字段说明
| 字段枚举 |
描述 |
| qrcode |
二维码 |
| barcode |
条码 |
示例
请求示例
返回示例
错误码
| code |
message |
原因 |
| 10000 |
Internal error |
内部错误 |
| 10003 |
Invalid parameter |
参数校验错误 |
| 10006 |
Invalid image |
图片资源校验错误 |
| 10400 |
download image file failed |
下载图片失败 |