发票图像识别查验接口
请求说明
调用此接口需开通【识别录入】插件，并需要联系客服，申请配置增值税发票识别和非增值税发票识别功能
HTTP请求方式：POST
base_url:
https://www.feeclouds.com
API:
/api/v3/ocr/check
请求参数格式:
form-data
注意事项
1. 调用超时时间，建议设置为300s。
2. 随着业务升级，接口返回字段会增加，但不会删减，请做好技术准备。
3. 数电票支持JPG、PNG、PDF、OFD、XML格式的文件的识别查验。
图像说明
仅支持单图像文件上传，单个文件中可包含多张发票
图像类型说明:
支持JPG,PNG,PDF,OFD,xml类型文件上传；图像要求为清晰无遮挡；文件大小不超过10M；参数格式为图像的url或者base64编码的文件流
url格式说明:
将图像的url直接赋值给file_data
文件流格式说明:
将图像文件流用base64编码后直接赋值给file_data。其中头部的参数“data:image/png;base64,”不需要传，只传其后的一长串字符串
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| company_key | str | 是 | 费耘系统提供的企业company_key |
| nonce_str | str | 是 | 6位随机字符串 |
| sign | str | 是 | 根据签名生成规则生成的签名 |
| file_data | str | 是 | 上传的图像文件，不参与签名生成，格式详见图像说明 |
| department_id | str | 是 | 获取部门信息接口中 is_branch=1的子公司对应的id |
| is_check | str | 否 | 0：不查验，1：查验不提交，2：查验并提交 注： 1、不传此参数时，默认为2 2、参数为0时，增值税票和非增值税票不查验且不提交 3、参数为1时，仅对增值税发票查验，且增值税票和非增值税票不提交 4、参数为2时，仅对增值税发票查验，且增值税发票和非增值税发票都提交；如果开通集团模式服务，则必须传发票归属子公司的department_id，作为非增值税票提交依据。 |
| user_id | str | 否 | 发票归属人的id |
| memo | str | 否 | 其他备注，可以为发票添加自定义备注 |
注：xml文件自带发票要素信息，在调用ocr接口时，默认查验消耗查验量，不消化识别量，无关is_check的值。
返回结果
发票识别成功json示例（is_check = 0）
{
"msg": "成功",
"code": 0,
"data": [
{
"fpzl": "10", // 发票类型 增值税电子普通发票
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"",
"memo":"213123",
"fplc":"第一联"
},
"ocr_result":{
“jshj”: "1158.23", // 价税合计
"fpdm": "011001600211", // 发票代码
"fphm": "62996502", // 发票号码
"kprq": "20171026", // 开票日期
"jym": "62862199951546693993", // 校验码
"je": "1025.64" // 税前金额
}
},
{
"fpzl": "101", // 发票类型 定额发票
"invoiceid": "60362a921c38450dbea55958804f5e1b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path": // 切图地址
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 号码
"total": "74.00" // 总金额
}
},
{
"fpzl": "102", // 发票类型 机打发票
"invoiceid": "60362a921c38450dbea55958804f5e2b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 号码
"date": "2019年5月21日", // 日期
"time": "12:22:22", // 时间
"check_code": "52657910788452000000", // 校验码
"category": "oil", // 种类，oil 表示是加油票
"total": "74.00", // 总金额
"xfmc": "北京缔联科技有限公司", // 销售方名称
"xfsbh": "15260000000000000G", // 销售方纳税人识别号
"gfmc": "北京大大科技有限公司", // 购买方方名称
"gfsbh": "11684616000000000D" // 购买方纳税人识别号
}
},
{
"fpzl": "103", // 出租车发票
"invoiceid": "60362a921c38450dbea55958804f5e3b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "133011680478", // 发票代码
"fphm": "01670989", // 发票号码
"date": "2017年08月29日", // 乘车日期
"time_geton": "12:47", // 上车时间
"time_getoff": "12:52", // 下车时间
"mileage": "1.9", // 里程
"total": "11.00", // 总金额
"place": "北京市" // 发票所在地
}
},
{
"fpzl": "104", // 火车票
"invoiceid": "60362a921c38450dbea55958804f5e4b",
"orientation":"90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"6.11",
"memo":"213123"
},
"ocr_result": {
"number": "66827300580918A042707", // 火车票编码（左下角）
"date": "2017年11月21日", // 乘车日期
"time": "21:53", // 乘车时间
"name": "张三", // 乘车人姓名
"station_geton": "杭州东", // 上车车站
"station_getoff": "北京", // 下车车站
"train_number": "G7383", // 车次
"seat": "二等座", // 座位类型
"train_code": "1A042707", // 票号（左上角）
"total": "74.00" // 总金额
}
},
{
"fpzl": "105", // 客运汽车
"invoiceid": "60362a921c38450dbea55958804f5e5b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"2.15", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 发票号码
"date": "2018年01月10日", // 日期
"time": "12:14", // 时间
"station_geton": "杭州", // 出发车站
"station_getoff": "北京", // 达到车站
"total": "74.00", // 总金额
"name": "张三" // 姓名
}
},
{
"fpzl": "106", // 航空运输电子客票行程单
"invoiceid": "60362a921c38450dbea55958804f5e6b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"61.10", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"user_name": "张三", // 乘机人姓名
"user_id":"256548545211254523", // 身份证号
"number": "1506498784112", // 电子客票号码
"check_code": "2345", // 验证码
"date": "2018年04月04日", // 填开日期
"agentcode": "XMN098,0987677", // 销售单位代号
"issue_by": "上海华城西南国际旅行社有限公司", // 填开单位
"fare": "730.00", // 票价
"tax": "10.00", // 税费
"fuel_surcharge": "10.00", // 燃油附加费
"caac_development_fund": "50.00", // 民航发展基金
"insurance": "10.00", // 保险费
"total": "800.00", // 总额
"flights": [ // 航班信息
{
"from_station":"上海", // 出发站
"to_station":"北京", // 到达站
"flight_number":"GS7563", // 航班号
"date":"2018年02月20日", // 乘机日期
"time":"12:34", // 乘机时间
"seat":"N", // 座位等级
"carrier": "国航" // 承运人
},
{
"from_station":"北京", // 出发站
"to_station":"伦敦", // 到达站
"flight_number":"QR890", // 航班号
"date":"2018年02月21日", // 乘机日期
"time":"15:06", // 乘机时间
"seat":"S", // 座位等级
"carrier": "国航" // 承运人
}
]
}
},
{
"fpzl": "108", // 过路费发票
"invoiceid": "60362a921c38450dbea55958804f5e8b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 发票号码
"date": "2018年01月10日", // 日期
"time": "12:14", // 时间
"entrance_station": "4001", // 入口
"exit_station": "6754", // 出口
"total": "74.00" // 总金额
}
}
]
}
发票识别并查验json示例（is_check = 1）
{
"msg": "成功",
"code": 0,
"data": [
{
"msg": "成功",
"code": 0,
"fpzl": "10",
"invoiceid": "60362a921c38450dbea55958804f5e0b",
"forbidens": [true,true,true,true,false],
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"gfdzdh": " ",
"txfbz": "N",
"cpybz":"N",
"fpdm": "011001600211",
"zfbz": "N",
"zfbz_new": "N",
"xfdzdh": "北京市顺义区仁和镇林河大街80259611",
"kprq": "20171026",
"gfsbh": "91654003MA77511234",
"dkbz": "1",
"title": "北京增值税普通发票(电子)",
"gfyhzh": " ",
"content": "01,10,011001600211,62996502,1025.64,20171026,62862199951546693993,BDA7,",
"bswj_match":"1",
"bswj": {
"file_type": "ofd",
"path": "https://app-fc-hybrid.oss-accelerate.aliyuncs.com/bswj/124/051002000113_15655349.ofd?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1620802492&Signature=igEWbqxsaBzhMf5ulKT7u6TOY7Q%3D",
"preview_url": "https://app-fc-hybrid.oss-accelerate.aliyuncs.com/bswj/124/051002000113_15655349.jpg?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1620802492&Signature=Ex6ACB6dfdwsh1%2BGJ4jewDhHXQw%3D"
},
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"jqbh": "661624180757",
"jshj": "1200.00",
"cycs": "",
"xfsbh": "911101136804960000",
"je": "1025.64",
"gfmc": "麦当劳餐厅",
"fpzl": "10",
"bz": "",
"fphm": "62996502",
"xfmc": "北京商贸有限责任公司",
"xfyhzh": "工行北京和平门支行0200215809200019999",
"jym": "62862199951546693993",
"se": "174.36",
"dedu_se":"174.36",
"memo":"213123",
"fplc":"第一联",
"tspzbz":""
},
"invoice_detail": [
{
"dj": "256.41025641",
"ggxh": "5010012",
"hwmc": "*餐饮服务*餐饮服务",
"tszcbs": "1",
"slv": "17",
"sl": "4",
"sjsl": "",
"dw": " ",
"je": "1025.64",
"se": "174.36",
"sjse": " "
}
],
"ocr_result":{
"jshj":"1158.23",
"fpdm": "011001600211",
"fphm": "62996502",
"kprq": "20171026",
"jym": "62862199951546693993",
"je": "1025.64"
}
},
{
"msg": "所查发票不存在",
"code": 20413,
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"invoice_detail": [],
"ocr_result":{
"fpdm": "011001600000",
"fphm": "62996222",
"kprq": "20171026",
"jym": "62862199951546693993",
"je": "1025.64"
}
},
{
"fpzl": "101", // 发票类型 定额发票
"invoiceid": "60362a921c38450dbea55958804f5e1b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 号码
"total": "74.00" // 总金额
}
},
{
"fpzl": "102", // 发票类型 机打发票
"invoiceid": "60362a921c38450dbea55958804f5e2b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 号码
"date": "2017年11月21日", // 日期
"time": "12:22:22", // 时间
"check_code": "52657910788452000000", // 校验码
"category": "oil", // 种类，oil 表示是加油票
"total": "74.00", // 总金额
"xfmc": "北京缔联科技有限公司", // 销售方名称
"xfsbh": "15260000000000000G", // 销售方纳税人识别号
"gfmc": "北京大大科技有限公司", // 购买方方名称
"gfsbh": "11684616000000000D" // 购买方纳税人识别号
}
},
{
"fpzl": "103", // 出租车发票
"invoiceid": "60362a921c38450dbea55958804f5e3b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "133011680478", // 发票代码
"fphm": "01670989", // 发票号码
"date": "2017年08月29日", // 乘车日期
"time_geton": "12:47", // 上车时间
"time_getoff": "12:52", // 下车时间
"mileage": "1.9", // 里程
"total": "11.00", // 总金额
"place": "北京市" // 发票所在地
}
},
{
"fpzl": "104", // 火车票
"invoiceid": "60362a921c38450dbea55958804f5e4b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"6.11", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"number": "66827300580918A042707", // 火车票编码（左下角）
"date": "2017年11月21日", // 乘车日期
"time": "21:53", // 乘车时间
"name": "张三", // 乘车人姓名
"station_geton": "杭州东", // 上车车站
"station_getoff": "北京", // 下车车站
"train_number": "G7383", // 车次
"seat": "二等座", // 座位类型
"train_code": "1A042707", // 票号（左上角）
"total": "74.00" // 总金额
}
},
{
"fpzl": "105", // 客运汽车
"invoiceid": "60362a921c38450dbea55958804f5e5b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"2.15", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 发票号码
"date": "2018年01月10日", // 日期
"time": "12:14", // 时间
"station_geton": "杭州", // 出发车站
"station_getoff": "北京", // 达到车站
"total": "74.00", // 总金额
"name": "张三" // 姓名
}
},
{
"fpzl": "106", // 航空运输电子客票行程单
"invoiceid": "60362a921c38450dbea55958804f5e6b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"61.10", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"user_name": "张三", // 乘机人姓名
"user_id":"256548545211254523", // 身份证号
"number": "1506498784112", // 电子客票号码
"check_code": "2345", // 验证码
"date": "2018年04月04日", // 填开日期
"agentcode": "XMN098,0987677", // 销售单位代号
"issue_by": "上海国际旅社有限公司", // 填开单位
"fare": "730.00", // 票价
"tax": "10.00", // 税费
"fuel_surcharge": "10.00", // 燃油附加费
"caac_development_fund": "50.00", // 民航发展基金
"insurance": "10.00", // 保险费
"total": "800.00", // 总额
"flights": [ // 航班信息
{
"from_station":"上海", // 出发站
"to_station":"北京", // 到达站
"flight_number":"GS7563", // 航班号
"date":"2018年02月20日", // 乘机日期
"time":"12:34", // 乘机时间
"seat":"N", // 座位等级
"carrier": "国航" // 承运人
},
{
"from_station":"北京", // 出发站
"to_station":"伦敦", // 到达站
"flight_number":"QR890", // 航班号
"date":"2018年02月21日", // 乘机日期
"time":"15:06", // 乘机时间
"seat":"S", // 座位等级
"carrier": "国航" // 承运人
}
]
}
},
{
"fpzl": "108", // 过路费发票
"invoiceid": "60362a921c38450dbea55958804f5e8b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 发票号码
"date": "2018年01月10日", // 日期
"time": "12:14", // 时间
"entrance_station": "4001", // 入口
"exit_station": "6754", // 出口
"total": "74.00" // 总金额
}
}
]
}
发票识别并查验json示例（is_check = 2）
{
"msg": "成功",
"code": 0,
"data": [
{
"msg": "禁止录入",
"code": 20509,
"fpzl": "10",
"invoiceid": "60362a921c38450dbea55958804f5e0b",
"forbidens": [true,true,true,true,false],
"orientation": "90", // 发票顺时针旋转方向
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"invoice": {
"gfdzdh": " ",
"txfbz": "N",
"cpybz":"N",
"fpdm": "011001600211",
"zfbz": "N",
"zfbz_new": "N",
"xfdzdh": "北京市顺义区仁和镇林河大街80259611",
"kprq": "20171026",
"gfsbh": "91654003MA77511234",
"dkbz": "1",
"title": "北京增值税普通发票(电子)",
"gfyhzh": " ",
"content": "01,10,011001600211,62996502,1025.64,20171026,62862199951546693993,BDA7,",
"bswj_match":"1",
"bswj": {
"file_type": "ofd",
"path": "https://app-fc-hybrid.oss-accelerate.aliyuncs.com/bswj/124/051002000113_15655349.ofd?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1620802492&Signature=igEWbqxsaBzhMf5ulKT7u6TOY7Q%3D",
"preview_url": "https://app-fc-hybrid.oss-accelerate.aliyuncs.com/bswj/124/051002000113_15655349.jpg?OSSAccessKeyId=UtsfGjiJTnHhgKLZ&Expires=1620802492&Signature=Ex6ACB6dfdwsh1%2BGJ4jewDhHXQw%3D"
},
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"jqbh": "661624180757",
"jshj": "1200.00",
"cycs": "",
"xfsbh": "911101136804960000",
"je": "1025.64",
"gfmc": "麦当劳餐厅",
"fpzl": "10",
"bz": "",
"fphm": "62996502",
"xfmc": "北京商贸有限责任公司",
"xfyhzh": "工行北京和平门支行0200215809200019999",
"jym": "62862199951546693993",
"se": "174.36",
"dedu_se":"174.36",
"memo":"213123",
"fplc":"第一联",
"tspzbz":""
},
"invoice_detail": [
{
"dj": "256.41025641",
"ggxh": "5010012",
"hwmc": "*餐饮服务*餐饮服务",
"tszcbs": "1",
"slv": "17",
"sl": "4",
"sjsl": "",
"dw": "",
"je": "1025.64",
"se": "174.36",
"sjse": ""
}
],
"ocr_result":{
"jshj":"1158.23",
"fpdm": "011001600211",
"fphm": "62996502",
"kprq": "20171026",
"jym": "62862199951546693993",
"je": "1025.64"
}
},
{
"msg": "所查发票不存在",
"code": 20413,
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"invoice_detail": [],
"ocr_result":{
"fpdm": "011001600000",
"fphm": "62996222",
"kprq": "20171026",
"jym": "62862199951546693993",
"je": "1025.64"
}
},
{ // 电子发票（铁路电子客票）
"msg": "禁止录入",
"signature_verify": 0,
"orientation": 0,
"code": 20509,
"invoice_detail": [],
"forbidens": [
true,
true,
false,
false,
false
],
"invoiceid": "a7b40e4c857f488393665da395ae7ba4",
"invoice": {
"file_path": "https://app-fc-hybrid-prod.oss-accelerate.aliyuncs.com/pictures_ocr/124/2216e98d-11dc-415c-89aa-e71b7647efd8.png?Expires=1723085039&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=gWJygEAO7ojxUzOuX%2B2WqH6s3Do%3D",
"gfmc": "国网内蒙古东部电力有限公司",
"cycs": "641",
"memo": null,
"pz": "",
"bswj": "",
"fpzl": "83",
"title": "电子发票（铁路电子客票）",
"zfbz_new": "0",
"content": ",,,22119121152000000001,58,20220609,",
"bswj_match": "",
"ywlx": "1",
"se": "4.79",
"cfsj": "17:37",
"kprq": "20220609",
"kttz": "--",
"cc": "G2581",
"gfsbh": "91150100692859595Q",
"fpdm": "",
"xb": "二等座",
"ccrq": "20220609",
"xm": "杜佳蔚",
"cx": "04车",
"cfz": "北京南",
"dzkph": "211522A086061098164112022",
"zjh": "211202******052792",
"jshj": "58.00",
"je": "53.21",
"ddz": "天津南",
"slv": "9",
"zfbz": "N",
"fphm": "22119121152000000001",
"xw": "05A号"
},
"ocr_result": {
"fpdm": "",
"kprq": "20220609",
"jshj": "58",
"je": "",
"fphm": "22119121152000000001",
"jym": ""
},
"region": [
2,
0,
640,
444
],
"fpzl": "83",
"region_path": "https://app-fc-hybrid-prod.oss-accelerate.aliyuncs.com/pictures_ocr/124/2216e98d-11dc-415c-89aa-e71b7647efd8.png?Expires=2038441439&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=zI7UYncB%2F170lK89v5LYA6eVoqw%3D"
},{ // 电子发票（航空运输电子客票行程单）
"msg": "禁止录入",
"signature_verify": 0,
"orientation": null,
"code": 20509,
"invoice_detail": [
{
"mdz": "大连-周水子 ",
"sfz": "北京-首都 T3",
"qfsj": "16:25",
"zwdj": "P",
"cyrq": "2024-04-25",
"hd": "1",
"cyr": "国航",
"hbh": "CA8910",
"kpjb": "P/CA0T240124"
}
],
"forbidens": [
true,
false,
false,
false,
false
],
"invoiceid": "",
"invoice": {
"file_path": "https://app-fc-hybrid-prod.oss-accelerate.aliyuncs.com/pictures_ocr/124/9bd03f2d-daf8-4086-af2a-f10d43c7c1d8.jpg?Expires=1723085347&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=MB7n%2BSjlE79KcziM%2Bq7IVlIeY2U%3D",
"gfmc": "业之峰诺华家居装饰集团股份有限公司",
"cycs": "10",
"memo": null,
"bswj": "",
"fpzl": "61",
"title": "电子发票（航空运输电子客票行程单）",
"zfbz_new": "0",
"content": ",,,24118999111000034772,640.00,20240428,",
"bswj_match": "",
"se": "48.71",
"kprq": "20240428",
"gngjbs": "国内",
"gfsbh": "911100006787552715",
"fpdm": "",
"gp": "",
"dkbz": "",
"xm": "钟云霞",
"dzkph": "9992355143925",
"zjh": "429006******162500",
"jshj": "640.00",
"zfbz": "N",
"fphm": "24118999111000034772"
},
"ocr_result": {
"fpdm": "",
"kprq": "20240428",
"jshj": "640.00",
"je": "",
"fphm": "24118999111000034772",
"jym": ""
},
"region": null,
"fpzl": "61",
"region_path": "https://app-fc-hybrid-prod.oss-accelerate.aliyuncs.com/pictures_ocr/124/9bd03f2d-daf8-4086-af2a-f10d43c7c1d8.jpg?Expires=2038441747&OSSAccessKeyId=LTAI5tA5egm1TVH8K1ucCgS3&Signature=BcUfqeYmxMgPu9wucw0kqNzg80I%3D"
},
{
"fpzl": "101", // 发票类型 定额发票
"invoiceid": "60362a921c38450dbea55958804f5e1b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 号码
"total": "74.00" // 总金额
}
},
{
"fpzl": "102", // 发票类型 机打发票
"invoiceid": "60362a921c38450dbea55958804f5e2b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 号码
"date": "2017年11月21日", // 日期
"time": "12:22:22", // 时间
"check_code": "52657910788452000000", // 校验码
"category": "oil", // 种类，oil 表示是加油票
"total": "74.00", // 总金额
"xfmc": "北京缔联科技有限公司", // 销售方名称
"xfsbh": "15260000000000000G", // 销售方纳税人识别号
"gfmc": "北京大大科技有限公司", // 购买方方名称
"gfsbh": "11684616000000000D" // 购买方纳税人识别号
}
},
{
"fpzl": "103", // 出租车发票
"invoiceid": "60362a921c38450dbea55958804f5e3b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "133011680478", // 发票代码
"fphm": "01670989", // 发票号码
"date": "2017年08月29日", // 乘车日期
"time_geton": "12:47", // 上车时间
"time_getoff": "12:52", // 下车时间
"mileage": "1.9", // 里程
"total": "11.00", // 总金额
"place": "北京市" // 发票所在地
}
},
{
"fpzl": "104", // 火车票
"invoiceid": "60362a921c38450dbea55958804f5e4b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"6.11", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"number": "66827300580918A042707", // 火车票编码（左下角）
"date": "2017年11月21日", // 乘车日期
"time": "21:53", // 乘车时间
"name": "张三", // 乘车人姓名
"station_geton": "杭州东", // 上车车站
"station_getoff": "北京", // 下车车站
"train_number": "G7383", // 车次
"seat": "二等座", // 座位类型
"train_code": "1A042707", // 票号（左上角）
"total": "74.00" // 总金额
}
},
{
"fpzl": "105", // 客运汽车
"invoiceid": "60362a921c38450dbea55958804f5e5b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"2.15", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 发票号码
"date": "2018年01月10日", // 日期
"time": "12:14", // 时间
"station_geton": "杭州", // 出发车站
"station_getoff": "北京", // 达到车站
"total": "74.00", // 总金额
"name": "张三" // 姓名
}
},
{
"fpzl": "106", // 航空运输电子客票行程单
"invoiceid": "60362a921c38450dbea55958804f5e6b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"dedu_se":"61.10", // 可抵扣税额
"memo":"213123"
},
"ocr_result": {
"user_name": "张三", // 乘机人姓名
"user_id":"256548545211254523", // 身份证号
"number": "1506498784112", // 电子客票号码
"check_code": "2345", // 验证码
"date": "2018年04月04日", // 填开日期
"agentcode": "XMN098,0987677", // 销售单位代号
"issue_by": "上海国际旅行社有限公司", // 填开单位
"fare": "730.00", // 票价
"tax": "10.00", // 税费
"fuel_surcharge": "10.00", // 燃油附加费
"caac_development_fund": "50.00", // 民航发展基金
"insurance": "10.00", // 保险费
"total": "800.00", // 总额
"flights": [ // 航班信息
{
"from_station":"上海", // 出发站
"to_station":"北京", // 到达站
"flight_number":"GS7563", // 航班号
"date":"2018年02月20日", // 乘机日期
"time":"12:34", // 乘机时间
"seat":"N", // 座位等级
"carrier": "国航" // 承运人
},
{
"from_station":"北京", // 出发站
"to_station":"伦敦", // 到达站
"flight_number":"QR890", // 航班号
"date":"2018年02月21日", // 乘机日期
"time":"15:06", // 乘机时间
"seat":"S", // 座位等级
"carrier": "国航" // 承运人
}
]
}
},
{
"fpzl": "108", // 过路费发票
"invoiceid": "60362a921c38450dbea55958804f5e8b",
"orientation": "90", // 发票顺时针旋转方向
"region": [100,100,200,200], // 发票左上点和右下点[x1, y1, x2, y2]
"region_path":
"https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",// 发票区域切割切图地址
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
},
"ocr_result": {
"fpdm": "6300161320", // 发票代码
"fphm": "15064112", // 发票号码
"date": "2018年01月10日", // 日期
"time": "12:14", // 时间
"entrance_station": "山西", // 入口
"exit_station": "太湖", // 出口
"total": "74.00" // 总金额
}
}
]
}
发票识别失败json示例
{
"msg": "OCR识别失败",
"code": 21035,
"data": {
"invoice": {
"file_path": "https://hybrid.feeclouds.com/pictures_ocr/309/aWGvUP7FHShCrpiGjcsXEX",
"memo":"213123"
}
}
}
返回参数说明
| 参数 | 参数类型 | 说明 |
|---|---|---|
| reason | str | 发票查验失败的原因 |
| forbidens | list | 列表中共有5个对象，依次代表发票抬头或纳税人识别号不一致、重复查验、货物名称黑名单、销售方黑名单、增值税专用发票四项校验。 1、发票抬头或纳税人识别号不一致 以下两种情况下，对象值为True a、企业启用发票抬头或纳税人识别号不一致禁止录入时，发票查验结果中的购方名称或纳税人识别号与企业设置的信息不一致（例外：货物属于企业所设置的货物白名单范围时，对象值为False）； b、有集团模式的企业在未上传“department_id”情况下，发票查验结果中的购方不属于任一子公司时，对象值为True； 2、重复查验 当查验发票在公司/集团范围内重复查验时，对象值为True； 3、货物名称黑名单 企业已设置货物名称黑名单，发票查验结果的货物名称包含货物名称黑名单内容时，对象值为True； 4、销售方黑名单 企业已设置企业黑名单，发票查验结果的销方企业属于企业黑名单时，对象值为True； 5、增值税专用发票四项校验 企业启用增值税专用发票四项校验，当发票查验结果的地址、电话、开户行、账号存在任一一项与企业信息不一致时，对象值为True。 |
| invoiceid | str | 该发票在费耘系统中的唯一标识 |
发票种类（fpzl）说明（增值税发票种类，请参见查验接口）
| 值 | 含义 |
|---|---|
| 101 | 定额发票 |
| 102 | 机打发票 |
| 103 | 出租车发票 |
| 104 | 火车票 |
| 105 | 客运汽车 |
| 106 | 航空运输电子客票行程单 |
| 108 | 过路费发票 |
返回参数(invoice)说明
invoice公共字段详见查验接口invoice公共字段说明
| 参数 | 参数类型 | 说明 |
|---|---|---|
| msg | str | 发票的识别结果 |
| file_path | str | 附件地址，有效时间为10分钟 |
| dedu_se | str | 发票可抵扣税额 |
| orientation | str | 发票顺时针旋转方向 |
| region | str | 发票左上点和右下点的坐标[x1, y1, x2, y2] |
| region_path | str | 切图地址，有效时间为10分钟 |
| fplc | str | 发票联次 |
| zfbz_new | str | Y：作废，N：正常，0：正常，2：作废，3：红冲，7：部分红冲，8：全额红冲 |
其他票据参数说明
出租车发票
| 参数 | 说明 |
|---|---|
| fpdm | 发票代码 |
| fphm | 发票号码 |
| date | 乘车日期 |
| time_geton | 上车时间 |
| time_getoff | 下车时间 |
| mileage | 里程 |
| total | 总金额 |
| place | 发票所在地 |
客运汽车票
| 参数 | 说明 |
|---|---|
| fpdm | 发票代码 |
| fphm | 发票号码 |
| date | 日期 |
| time | 时间 |
| station_geton | 出发车站 |
| station_getoff | 到达车站 |
| total | 总金额 |
| name | 姓名 |
火车票
| 参数 | 说明 |
|---|---|
| number | 火车票编码（左下角） |
| train_code | 票号（左上角） |
| date | 乘车日期 |
| time | 乘车时间 |
| name | 乘车人姓名 |
| station_geton | 上车车站 |
| station_getoff | 下车车站 |
| train_number | 车次 |
| seat | 座位类型 |
| total | 总金额 |
航空运输电子客票行程单
| 参数 | 说明 |
|---|---|
| user_name | 乘机人姓名 |
| user_id | 乘机人身份证号，非费用归属人id |
| number | 电子客票号码 |
| check_code | 验证码 |
| date | 填开日期 |
| agentcode | 销售单位代号 |
| issue_by | 填开单位 |
| fare | 票价 |
| tax | 税费 |
| fuel_surcharge | 燃油附加费 |
| caac_development_fund | 民航发展基金 |
| insurance | 保险费 |
| total | 总额 |
| from_station | 出发站 |
| to_station | 到达站 |
| flight_number | 航班号 |
| date | 乘机日期 |
| time | 乘机时间 |
| seat | 座位等级 |
| carrier | 承运人 |
定额发票
| 参数 | 说明 |
|---|---|
| fpdm | 发票代码 |
| fphm | 号码 |
| total | 总金额 |
机打发票
| 参数 | 说明 |
|---|---|
| fpdm | 发票代码 |
| fphm | 号码 |
| date | 日期 |
| time | 时间 |
| check_code | 校验码 |
| category | 种类，oil 表示是加油票 |
| total | 总金额 |
| xfmc | 销售方名称 |
| xfsbh | 销售方纳税人识别号 |
| gfmc | 购买方名称 |
| gfsbh | 购买方纳税人识别号 |
过路费发票
| 参数 | 说明 |
|---|---|
| fpdm | 发票代码 |
| fphm | 发票号码 |
| date | 日期 |
| time | 时间 |
| entrance_station | 入口 |
| exit_station | 出口 |
| total | 总金额 |
返回参数(invoice_detail)说明
详见查验接口invoice_detail说明
返回参数(ocr_result)说明
OCR识别的发票识别的要素信息，参数说明见查验接口内“返回参数公共字段说明”
可识别票据样例
1.火车票 2.过路费发票 3.出租车发票 4.机打发票 5.航空运输电子客票行程单 6.客运汽车票 7.定额发票
不可识别票据样例（持续更新）
1.手写发票 2.收据 3. 老式汽车票 4.登机牌
