接口文档
票据识别(OCR)
普通票据OCR识别
普通票据识别
通用票据OCR识别。支持40+票种:增值税发票(01/03/04/08/10/11/14/15)/数电票(0910/0920/0901/0903/0904/0915/0930/0940/8208)/航空铁路(61/83/902)/海关缴款书(17)/区块链(100)/财政票据(101非税/电子医疗)/通用电子(102)/车辆通行费(103/14/904)/定额(801)/出租车(900)/火车票(901)/机打(903)/客运汽车(905)/购物小票(906)/网约车行程单(907)/完税证明(908)/船票(909深圳)/可报销其他(910)/海关报关单(911出口/912进口)等。文件类型:jpg/pdf/ofd/png/xml/jpeg/tiff/bmp。3种上传方式任选:imageUrl/imageData/imageFile
登录查看报价
POST
https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/ocr/recognize
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| imageUrl | String | 否 | 发票文件HTTP链接(3选1) |
| imageData | String | 否 | 发票文件Base64数据(3选1) |
| imageFile | File | 否 | 发票文件流(3选1,multipart上传) |
| customReqId | String | 否 | 请求ID |
请求示例
JSON
{
"customReqId": "10001999xxxxxxxx",
"imageUrl": "https:\/\/example.com\/invoice.pdf"
}
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | String | 2000=成功;ImageIsInvalid=图片无效;NotSupport=不支持的发票类型 |
| data.success | Boolean | 识别是否成功 |
| data.imageUrl | String | 图片存储URL(供查看) |
| data.totalCount | String | 识别计费数量 |
| data.customReqId | String | 请求ID |
| data.datas | Array | 识别结果数组(多张发票)。各票种结构不同,核心字段fplx/fpdm/fphm/kprq/je/jshj/xfmc/xfsbh/gfmc/gfsbh/hwxx。注:旧字段data.data已废弃,统一用data.datas |
响应示例
JSON
{
"reqId": "4fc638d8d817417c868edb2f8704dc4f",
"code": "2000",
"success": true,
"data": {
"customReqId": "1000xxxxxx",
"imageUrl": "http:\/\/qxy-oss\/xxx.jpg",
"success": true,
"totalCount": "1",
"datas": [
{
"fplx": "0910",
"fpdm": null,
"fphm": "00xxxx07",
"kprq": "2023-05-29 00:00:00",
"jym": "2394xxxxxx",
"xfsbh": "91xxxxxx281A",
"xfmc": "上海XX公司",
"gfsbh": "91xxxxxx0000",
"gfmc": "北京XX公司",
"je": 92,
"se": 23,
"jshj": 16,
"jshjcn": "玖万叁仟圆整",
"fpxflx": "服务",
"fwlx": "信息技术服务",
"hwxx": [
{
"mc": "*信息技术服务*",
"ggxh": "V9.3",
"jldw": "套",
"dj": "1400.433",
"sl": "0.5",
"je": 21,
"slv": 32,
"se": 60
}
]
}
]
}
}
© 2026 星云税融API. All rights reserved.
如需接入支持，请联系技术团队 | 注册账号