发票识别
1、接口描述
该接口用于发票识别
支持增值税专用发票、增值税普通发票、增值税专用发票（电子）、增值税普通发票（电子）、增值税普通发票（卷票）、通行费发票
支持机动车销售统一发票、二手车统一销售发票
支持定额发票
支持区块链发票
支持通用电子发票
支持电子发票（普通发票）、电子发票（增值税专用发票）、全电纸质发票(增值税专用发票)、全电纸质发票(增值税普通发票)、电子发票（铁路电子客票）（仅支持ofd原件识别）、电子发票（航空运输电子客票行程单）（仅支持ofd原件识别）
支持出租车发票、火车票、航空运输电子客票行程单
支持客运汽车、船票（目前仅支持深圳）、过路费发票(通行费)、可报销其他发票
支持购物小票、滴滴出行行程单（仅支持pdf原件识别）
2、接口地址
POST /v1/FP/sb HTTP/1.1
3、请求参数
- 参数说明
请求参数为 JSON 格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| single | boolean | 否 | 是否单张发票识别，不传默认 true |
| imageUrl | String | 否 | 发票图片链接 |
| imageData | String | 否 | 发票图片 Base64 数据，最大不能超过5MB |
| imageFile | Binary | 否 | 发票图片或Ofd文件流 |
发票图片信息相关参数imageUrl、imageData、imageFile只需传入一项，任选一项上传即可；
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
//发票图片链接方式（单张）
{
"imageUrl": "xx"
}
//发票图片 Base64 数据方式（单张）
{
"imageData": "xx"
}
//发票图片或Ofd文件流方式（单张）
{
"imageFile": xx
}
//发票图片链接方式（一张图包含多张发票）
{
"single":false,
"imageUrl": "xx"
}
//发票图片 Base64 数据方式（一张图包含多张发票）
{
"single":false,
"imageData": "xx"
}
//发票图片或Ofd文件流方式（一张图包含多张发票）
{
"single":false,
"imageFile": xx
}
4、返回结果
- 返回结果
返回结果为JSON格式，详细示例见发票识别返回结果示例及字段说明 。
//增值税专用发票识别成功返回结果
{
"result":{
"req_id":"8b644d66cd2e48b4933d0a4bc7bcbda5",
"success":true,
"time":1165,
"timestamp":1669708577100
},
"value":{
"single":true,
"fkBz":"13b23025b74d9808c8608b7fce233050",
"data":{
"title":"北京增值税专用发票", --标题
"jdfpdm":"11******30", --机打发票代码
"jdfphm":"51****40", --机打发票号码
"fplc":"抵扣联", --发票联次
"fplcNum":"第二联", --发票是第几联
"province":"北京市", --省份
"city":"", --城市
"qrcode":["********************"], --二维码
"barcode":["********************"], --条码
"xfsbh":"9111*********40XR",
"company_seal":"1",
"gfmc":"****科技(北京)有限公司",
"gmfyhzh":"招商银行1109*******0902",
"xsfdzdh":"北京市**区**门外大街**号*层4016***8898",
"se":1698.11,
"skm":"0390-1010+2/0*7-39-+87079*94,797+<2*8-466+19>3<5/19745207,2*0-+38>8-<5/*0471><4974+127,+/>710670601--8203618281-198",
"kprq":"2016-11-01 00:00:00",
"bz":"",
"imageSize":"1279,786",
"skr":"管理员",
"sbbh":"499922291823",
"gfsbh":"1101*******9631",
"fpdm":"11******30",
"fplx":"01",
"kpr":"管理员",
"fhr":"管理员",
"fpxflx":"服务", --发票消费类型
"gmfdzdh":"北京市**区**园内的**大学学研综合楼*层B903-0****0-82****50",
"xsfyhzh":"建行北京市**支行营业部1100************7384",
"jd":0,
"jshj":30000,
"page":0,
"je":28301.89,
"xfmc":"北京******有限公司",
"yzxx":"", --印章信息
"dzbz":"", --电子标志
“txfbz":"", --通行费标志
"ccs":"" --车船税
"hwxx":[
{
"ggxh":"",
"jldw":"",
"dj":"28301.8867924",
"se":1698.11,
"ysse":"1698.11",
"mc":"其他现代服务",
"sl":"1",
"je":28301.89,
"slv":0.06,
"ysslv":"6%"
}
],
"fphm":"51****40",
"jym":""
},
"success":true
}
}
// 增值税电子普通发票识别成功返回结果
{
"result":{
"req_id":"550bef547dc942db87429916affb72b2",
"success":true,
"time":1434,
"timestamp":1643191040538
},
"value":{
"single":true,
"fkBz":"5f2fc367bd0bdcdab55ad941c13223e0",
"data":{
"xfsbh":"9144***********6084",
"company_seal":"1", -- 是否有公司印章（0：没有；1：有）
"gfmc":"西陇*****公司",
"tspzDm":"06", --特殊票种代码，02农产品收购发票，06通行费发票，08成品油发票
"xsfdzdh":"广东省********大马路10号之一首层自编G号020-82373038",
"se":3.84,
"skm":"03<45-2*94-033/575>+61-2->0>,93>5***329-58*****882>0/-3-,+29+*7*+07<1<35>10/>14<>/6<+,0/<748<+0401/5681921-458*<88",
"kprq":"2022-01-06 00:00:00",
"bz":"汇总开具",
"skr":"黄*芬",
"sbbh":"499099656856",
"gfsbh":"9144************168R",
"fpdm":"0440****0112",
"fplx":"14",
"kpr":"徐*丹",
"fhr":"黄*芬",
"fpxflx":"交通", --发票消费类型
"xsfyhzh":"中国银行虎门支行7250****3788",
"jd":0,
"jshj":131.88,
"je":128.04,
"xfmc":"广深珠****有限公司",
"fphm":"07****01",
"jym":"11460***********3162",
"page":0, --页码
"imageSize":"1220,788", --当前页尺寸大小
"yzxx":"", --印章信息
"dzbz":"", --电子标志
“txfbz":"", --通行费标志
"ccs":"" --车船税
"hwxx":[
{
"ggxh":"粤STN**9",
"jldw":"客车",
"dj":"20211230",
"se":3.84,
"ysse":"3.84",
"mc":"*经营租赁*通行费",
"sl":"20211202",
"je":128.04,
"slv":0.03,
"ysslv":"3%"
}
]
},
"success":true,
"imageUrl":"https://image.*****.com/invoice/2022/01/13/60a4b6071dc9f278ea833f44/61df*****************fe00.pdf" --参数imageUrl，传图片链接方式才会返回该字段
}
}
// 增值税电子专用发票识别成功返回结果
{
"result":{
"req_id":"33a1060b8edc4d9abecb1998c87e0c10",
"success":true,
"time":1400,
"timestamp":1643191620761
},
"value":{
"single":true,
"fkBz":"cb4f11a5e50e74278fe21ab91510b469",
"data":{
"xfsbh":"913*******E80",
"company_seal":"0", -- 是否有公司印章（0：没有；1：有）
"gfmc":"青岛*********股份有限公司",
"gmfyhzh":"中国银行青岛******2364****9478",
"xsfdzdh":"青岛市*******168号13A层13A03室-53053*****578",
"se":29.7,
"skm":"0060-98-6<+++*-/-819930*7358,>4*1724+07688>0-8>-335+*2/8-,5+4496>*3*55*623-+7****451/0,*+0-/98<5+6>>10***571+3983>/",
"kprq":"2021-12-17 00:00:00",
"bz":"",
"skr":"高*红",
"sbbh":"9170*****38248",
"gfsbh":"9137*******8945R",
"fpdm":"0370****0213",
"fplx":"08",
"kpr":"曲*",
"fhr":"吕*霖",
"gmfdzdh":"青岛市城*****10号 0532-8*****238",
"fpxflx":"服务", --发票消费类型
"xsfyhzh":"青岛银行**支行80202******0357",
"jd":0,
"jshj":3000,
"je":2970.3,
"xfmc":"青岛中*******有限公司",
"yzxx":"", --印章信息
"dzbz":"", --电子标志
“txfbz":"", --通行费标志
"ccs":"" --车船税
"hwxx":[
{
"ggxh":"",
"jldw":"",
"dj":"2970.29702970297",
"se":29.7,
"ysse":"29.70",
"mc":"*经纪代理服务*知识产权服务费",
"sl":"1",
"je":2970.3,
"slv":0.01,
"ysslv":"1%"
}
],
"fphm":"00****72",
"jym":"0327***********4792"
},
"success":true,
"imageUrl":"https://image.*********.com/invoice/2022/01/14/616e37e5630f2041fe4ba8a1/***********.png" -- 参数imageUrl，传图片链接方式才会返回该字段
}
}
//区块链发票识别成功返回结果
{
"result":{
"req_id":"67704e36708b49e5ad2a61a2ae9fc282",
"success":true,
"time":9512,
"timestamp":1671713337326
},
"value":{
"single":true,
"fkBz":"f973bb239a86056c57bba232446a7eef",
"data":{
"xfsbh":"9253**********U755", --销方识别号
"company_seal":"1", --是否有公司印章（0：没有；1：有）
"city":"",
"gfmc":"西双版纳雅居乐旅游置业有限公司", --购方名称
"qrcode":["01,10,153******100,03****51,9253**********U755,1199.01,20210816,00**1a8"], --二维码， 返回信息包含发票代码、发票号码、税前金额、开票日期、校验码
"title":"云南省通用电子发票", --标题
"xsfdzdh":"云南省西双版纳傣族自治州旅游度假区***农场第**居民点 135*****222", --销售方地址电话
"jzdw":"国家税务总局", --监制单位
"jshjcn":"壹仟贰佰壹拾壹元整", --价税合计中文大写
"se":11.99, --税额
"province":"云南省", --省
"skm":"009ccc************************444e1a8", --密码区
"kprq":"2021-08-16 00:00:00", --开票日期
"bz":"", --备注
"imageSize":"1035,667", --图片分辨率
"skr":"钟*", --收款人
"gfsbh":"9153**********6530", --购方识别号
"fpdm":"153******100", --发票代码
"fplx":"100", --发票类型
"kpr":"钟*", --开票人
"fwlx":"餐饮服务", --服务类型
"fhr":"钟**", --复核人
"fpxflx":"餐饮", --发票消费类型
"xsfyhzh":"中国建设银行**市**路支行 6217***********6277", --销售方银行账号
"jd":0, --顺时针旋转角度
"jshj":1211, --价税合计
"page":0, --页码
"je":1199.01, --金额
"xfmc":"曼****江鱼馆", --销方名称
"hwxx":[ --货物信息
{
"ggxh":"", --规格型号
"se":11.99, --税额
"jldw":"桌", --计量单位
"ysse":"11.99", --原始税额
"mc":"*餐饮服务*餐饮服务", --名称
"dj":"1199.01000000", --单价
"sl":"1", --数量
"je":1199.01, --金额
"slv":0.01, --税率
"ysslv":"1%" --原始税率
}
],
"fphm":"03****51", --发票号码
"jym":"4***8" --校验码
},
"success":true --识别是否成功，true成功，false失败
}
}
// 定额发票识别成功返回结果
{
"result":{
"req_id":"6a8bc9a8c9354db1b673a336cd40f911",
"success":true,
"time":4667,
"timestamp":1653969250186
},
"value":{
"single":true,
"fkBz":"9faf74c147f6132fb1ea79861e455538",
"data":{
"fpdm":"1510****E001", --发票代码
"company_seal":"1", -- 是否有公司印章（0：没有；1：有）
"fpxflx":"餐饮", --发票消费类型
"fplx":"801", --发票类型
"jd":0, --旋转角度
"je":20, --金额
"page":0, --页码
"imageSize":"3024,4032", --当前页尺寸大小
"xfmc":"***市物边***餐饮店", --销方名称
"xfsbh":"9251**********F11R", --销方税号
"fphm":"04****02" --发票号码
},
"success":true,
"imageUrl":"https://image.fenbeitong.com/invoice/2022/01/14/61249dcb6f933a7e7109d8e9/61e0f1f0531b2e1a2fb19be4.jpg" -- 参数imageUrl，传图片链接方式才会返回该字段
}
}
//机打发票返回示例
{
"result":{
"req_id":"c612b49ee65e4283b38f29c9a2cf3cc1",
"success":true,
"time":3144,
"timestamp":1648782687462
},
"value":{
"single":true,
"fkBz":"28bd1c66f55a508a12475ecb7d30f72a",
"data":{
"xfsbh":"41122********9551501",
"company_seal":"1",
"gfmc":"洛阳市***纪委",
"kprq":"2017-11-30 00:00:00",
"gfsbh":"",
"fpdm":"1410****0043",
"fplx":"903", --发票类型
"fpxflx":"办公", --发票消费类型
"jshj":6200,
"jd":0,
"page":0, --页码
"imageSize":"3264,1708", --当前页尺寸大小
"xfmc":"洛阳市******电脑商行",
"hwxx":[
{
"jldw":"套",
"mc":"戴尔****电脑",
"sl":"1"
},
{
"jldw":"台",
"mc":"惠*打印机",
"dj":"3500.00",
"sl":"1",
"je":3500
},
{
"mc":"",
"dj":"2700.00",
"je":2700
}
],
"fphm":"00****93",
"jym":""
},
"success":true
}
}
//全电发票（普通发票）
{
"result":{
"req_id":"34a6e7a71f3745e7b47e68bef1049670",
"success":true,
"time":874,
"timestamp":1651059659981
},
"value":{
"single":true, --是否单张发票识别标识，true单张，false非单张
"fkBz":"33d16faf5113518bf547137f63aa726d", --反馈标识
"data":{
"xfsbh":"9131*********DL2G", --销售方识别号
"company_seal":"0", --是否有公司印章（0：没有；1：有）
"gfmc":"上海**信息技术有限公司", --购买方名称
"jzdw":"国家税务总局", --监制单位
"jshj":1000, --价税合计
"jshjcn":"壹仟元整", --价税合计（中文大写）
"se":56.6, --税额
"kprq":"2021-12-20 00:00:00", --开票日期
"bz":"", --备注
"imageSize":"1190,1684", --当前页尺寸大小
"skr":"", --收款人
"gfsbh":"9131*********189Q", --购买方识别号
"fpdm":"", --发票代码（全电发票无发票代码）
"fplx":"0910", --发票类型
"kpr":"祝*", --开票人
"fpbt":"电子发票普通发票", --发票标题
"fwlx":"信息技术服务", --服务类型
"fhr":"", --复核人
"xmmc":"*信息技术服务*技术服务费", --项目名称
"fpxflx":"服务", --发票消费类型
"jd":0, --旋转角度
"page":0, --页码
"je":943.4, --金额
"xfmc":"企享云服(上海)信息有限公司", --销售方名称
"xsfyz":"0", --是否有销售方(章)标记（0：没有；1：有）
"qdbq":"", --全电票标签（建筑服务，货物运输服务，不动产经营租赁服务，旅客运输服务）
"jzbz":"", --建筑标志，是否为建筑标志,仅专用建筑发票返回此字段值。1为建筑专用发票
"dzbz":"", --电子标志
"hwxx":[
{
"ggxh":"", --规格型号
"jldw":"", --计量单位
"dj":"943.39622642", --单价
"se":56.6, --税额
"ysse":"56.60", --原始税额
"mc":"*信息技术服务*技术服务费", --名称
"sl":"1", --数量
"je":943.4, --金额
"slv":0.06, --税率
"ysslv":"6%" --原始税率
"jzfwfsd":"", --建筑服务发生地，仅当全电标签为建筑服务时返回
"jzxmmc":"", --建筑项目名称，仅当全电标签为建筑服务时返回
"cqzh":"", --产权证书/不动产权证号，仅当全电标签为不动产经营租赁服务时返回
"mjdw":"" --面积单位，仅当全电标签为不动产经营租赁服务时返回
}
],
"ysxx": [ --运输信息列表，仅当全电标签为货物运输服务/旅客运输服务时返回
{
"ysgjph": "豫HR****", --运输工具牌号，仅当全电标签为货物运输服务/旅客运输服务时返回
"yshwmc": "配件、钢板", --运输货物名称，仅当全电标签为货物运输服务/旅客运输服务时返回
"ysgjlx": "公路运输", --运输工具类型，仅当全电标签为货物运输服务/旅客运输服务时返回
"ddd": "**省**市**县", --到达地，仅当全电标签为货物运输服务/旅客运输服务时返回
"cfd": "**市***区", --出发地，仅当全电标签为货物运输服务/旅客运输服务时返回
"cxr": "叶*", --出行人，仅当全电标签为旅客运输服务时返回此字段
"yxsfzjh": "350221********5010", --有效身份证号，仅当全电标签为旅客运输服务时返回此字段
"cxrq": "2022-12-01", --出行日期仅当全电标签为旅客运输服务时返回此字段
"dj": "" --等级仅当全电标签为旅客运输服务时返回此字段
}
],
"fphm":"2131************0064", --发票号码
"jym":"" --校验码
},
"success":true
}
}
//全电发票(增值税专用发票)
{
"result":{
"req_id":"4b0cadd3cda947918ebcb91649c9a639",
"success":true,
"time":932,
"timestamp":1651059764467
},
"value":{
"single":true,
"fkBz":"d94c16a6f92a0d1e3ef7abb03d343508",
"data":{
"xfsbh":"9131*********281C", --销售方识别号
"company_seal":"0", --是否有公司印章（0：没有；1：有）
"gfmc":"***商务有限公司", --购买方名称
"jzdw":"国家税务总局", --监制单位
"jshj":1129.99, --价税合计
"jshjcn":"壹仟壹佰贰拾玖圆玖角玖分", --价税合计（中文大写）
"se":130, --税额
"kprq":"2021-12-01 00:00:00", --开票日期
"bz":"", --备注
"imageSize":"887,595", --当前页尺寸大小
"skr":"", --收款人
"gfsbh":"9131**********632G", --购买方识别号
"fpdm":"", --发票代码
"fplx":"0920", --发票类型
"kpr":"沈**", --开票人
"fpbt":"电子发票(增值税专用发票)", --发票标题
"fwlx":"纸制品", --服务类型
"fhr":"", --复核人
"xmmc":"*纸制品*积点卡", --项目名称
"fpxflx":"日用", --发票消费类型
"jd":0, --旋转角度
"page":0, --页码
"je":999.99, --金额
"xfmc":"上海**商贸有限公司", --销售方名称
"xsfyz":"0", --是否有销售方(章)标记（0：没有；1：有）
"qdbq":"", --全电票标签（建筑服务，货物运输服务，不动产经营租赁服务，旅客运输服务）
"jzbz":"", --建筑标志，是否为建筑标志,仅专用建筑发票返回此字段值。1为建筑专用发票
"dzbz":"", --电子标志
"hwxx":[
{
"ggxh":"", --规格型号
"jldw":"张", --计量单位
"dj":"0.3185841000", --单价
"se":130, --税额
"ysse":"130.00", --原始税额
"mc":"*纸制品*积点卡", --名称
"sl":"3138.857212", --数量
"je":999.99, --金额
"slv":1.39, --税率
"ysslv":"139", --原始税率
"jzfwfsd":"", --建筑服务发生地，仅当全电标签为建筑服务时返回
"jzxmmc":"", --建筑项目名称，仅当全电标签为建筑服务时返回
"cqzh":"", --产权证书/不动产权证号，仅当全电标签为不动产经营租赁服务时返回
"mjdw":"" --面积单位，仅当全电标签为不动产经营租赁服务时返回
}
],
"ysxx": [ --运输信息列表，仅当全电标签为货物运输服务/旅客运输服务时返回
{
"ysgjph": "豫HR****", --运输工具牌号，仅当全电标签为货物运输服务/旅客运输服务时返回
"yshwmc": "配件、钢板", --运输货物名称，仅当全电标签为货物运输服务/旅客运输服务时返回
"ysgjlx": "公路运输", --运输工具类型，仅当全电标签为货物运输服务/旅客运输服务时返回
"ddd": "**省**市**县", --到达地，仅当全电标签为货物运输服务/旅客运输服务时返回
"cfd": "**市***区", --出发地，仅当全电标签为货物运输服务/旅客运输服务时返回
"cxr": "叶*", --出行人，仅当全电标签为旅客运输服务时返回此字段
"yxsfzjh": "350221********5010", --有效身份证号，仅当全电标签为旅客运输服务时返回此字段
"cxrq": "2022-12-01", --出行日期仅当全电标签为旅客运输服务时返回此字段
"dj": "" --等级仅当全电标签为旅客运输服务时返回此字段
}
],
"fphm":"2131**************1061", --发票号码
"jym":"" --校验码
},
"success":true --识别是否成功的标识，true成功，false失败
}
}
//全电发票明细为多页时识别成功返回报文
{
"result": {
"success": true,
"req_id": "1f37c66e43b9435db272d3cb2bc88df9",
"timestamp": 1681378148978,
"time": 40355
},
"value": {
"imageUrl": "http://tu.92086.top/i/2023/04/13/sj9wm6.pdf",
"type": null,
"single": false,
"ylpj": null,
"success": true,
"code": null,
"message": null,
"data": null,
"datas": [
{
"fplx": "0920",
"jd": 0,
"wz": "0,0,595,842",
"fpxflx": "电器",
"fwlx": "家用厨房电器具",
"company_seal": "0",
"imageSize": "595,842",
"page": 0,
"title": "电子发票(增值税专用发票)",
"jzdw": "国家税务总局",
"province": "",
"city": "",
"qrcode": [
"01,31, ,23312000000007781965,21573.75,20230316, ,BCA9"
],
"fpdm": "",
"fphm": "23312000000007781965",
"kprq": "2023-03-16 00:00:00",
"jym": "",
"xfsbh": "91310113MA1GMT8R4G",
"xfmc": "上海斐溢智能科技有限公司",
"gfsbh": "91310000734574775Q",
"gfmc": "西域智慧供应链（上海）股份公司",
"je": 19091.81,
"se": 2481.94,
"jshjcn": "",
"bz": "",
"kpr": "袁程程",
"skr": "",
"fhr": "",
"qdbq":"", --全电标签
"dzbz":"", --电子标志
"hwxx": [
{
"mc": "*家用美容保健电器*SKG颈椎按摩仪",
"ggxh": "4098时尚款",
"sl": "1",
"jldw": "个",
"dj": "175.221238938053",
"je": 175.22,
"slv": 0.13,
"ysslv": "13%",
"se": 22.78,
"ysse": "22.78"
},
{
"mc": "*家用美容保健电器*SKG颈椎按摩器",
"ggxh": "4098时尚款",
"sl": "1",
"jldw": "个",
"dj": "181.41592920354",
"je": 181.42,
"slv": 0.13,
"ysslv": "13%",
"se": 23.58,
"ysse": "23.58"
},
{
"mc": "*空调*奥克斯加湿器",
"ggxh": "AJ-H808T",
"sl": "1",
"jldw": "台",
"dj": "173.451327433628",
"je": 173.45,
"slv": 0.13,
"ysslv": "13%",
"se": 22.55,
"ysse": "22.55"
},
{
"mc": "*家用厨房电器具*长虹电热水壶CSH-16D01",
"ggxh": "CSH-16D01",
"sl": "1",
"jldw": "台",
"dj": "64.6017699115044",
"je": 64.6,
"slv": 0.13,
"ysslv": "13%",
"se": 8.4,
"ysse": "8.40"
},
{
"mc": "*家用通风电器具*先锋电风扇",
"ggxh": "DD1605",
"sl": "2",
"jldw": "台",
"dj": "202.654867256637",
"je": 405.31,
"slv": 0.13,
"ysslv": "13%",
"se": 52.69,
"ysse": "52.69"
},
{
"mc": "*家用通风电器具*先锋电风扇",
"ggxh": "DD2102R",
"sl": "1",
"jldw": "台",
"dj": "164.601769911504",
"je": 164.6,
"slv": 0.13,
"ysslv": "13%",
"se": 21.4,
"ysse": "21.40"
},
{
"mc": "*家用电热电力器*先锋取暖器",
"ggxh": "DS1555",
"sl": "20",
"jldw": "台",
"dj": "521.238938053097",
"je": 10424.78,
"slv": 0.13,
"ysslv": "13%",
"se": 1355.22,
"ysse": "1355.22"
},
{
"mc": "*家用美容保健电器*SKG颈椎按摩仪",
"ggxh": "K3-1T",
"sl": "10",
"jldw": "台",
"dj": "141.592920353982",
"je": 1415.93,
"slv": 0.13,
"ysslv": "13%",
"se": 184.07,
"ysse": "184.07"
},
{
"mc": "*家用厨房电器具*龙的电陶炉LD-DTL207C",
"ggxh": "LD-DTL207C",
"sl": "2",
"jldw": "台",
"dj": "132.743362831858",
"je": 265.49,
"slv": 0.13,
"ysslv": "13%",
"se": 34.51,
"ysse": "34.51"
},
{
"mc": "*家用厨房电器具*龙的原汁机",
"ggxh": "LD-GZ25A",
"sl": "1",
"jldw": "台",
"dj": "141.371681415929",
"je": 141.37,
"slv": 0.13,
"ysslv": "13%",
"se": 18.38,
"ysse": "18.38"
},
{
"mc": "*家用厨房电器具*龙的涮烤一体电火锅",
"ggxh": "LD-HG150C",
"sl": "6",
"jldw": "台",
"dj": "116.814159292035",
"je": 700.88,
"slv": 0.13,
"ysslv": "13%",
"se": 91.12,
"ysse": "91.12"
},
{
"mc": "*家用厨房电器具*龙的鸳鸯电火锅",
"ggxh": "LD-HG5030",
"sl": "1",
"jldw": "台",
"dj": "138.053097345133",
"je": 138.05,
"slv": 0.13,
"ysslv": "13%",
"se": 17.95,
"ysse": "17.95"
},
{
"mc": "*家用厨房电器具*龙的烤箱",
"ggxh": "LD-KX201A",
"sl": "1",
"jldw": "台",
"dj": "208.849557522124",
"je": 208.85,
"slv": 0.13,
"ysslv": "13%",
"se": 27.15,
"ysse": "27.15"
},
{
"mc": "*家用厨房电器具*龙的电水壶",
"ggxh": "LD-SH1850",
"sl": "3",
"jldw": "台",
"dj": "64.6017699115044",
"je": 193.81,
"slv": 0.13,
"ysslv": "13%",
"se": 25.19,
"ysse": "25.19"
},
{
"mc": "*家用厨房电器具*龙的煮茶器",
"ggxh": "LD-ZC081A",
"sl": "1",
"jldw": "台",
"dj": "164.601769911504",
"je": 164.6,
"slv": 0.13,
"ysslv": "13%",
"se": 21.4,
"ysse": "21.40"
},
{
"mc": "*家用清洁电器具*莱克吸尘器",
"ggxh": "S1025",
"sl": "2",
"jldw": "台",
"dj": "203.53982300885",
"je": 407.08,
"slv": 0.13,
"ysslv": "13%",
"se": 52.92,
"ysse": "52.92"
},
{
"mc": "*家用厨房电器具*苏泊尔电热水瓶",
"ggxh": "SW-50S56A",
"sl": "6",
"jldw": "台",
"dj": "215.044247787611",
"je": 1290.27,
"slv": 0.13,
"ysslv": "13%",
"se": 167.73,
"ysse": "167.73"
},
{
"mc": "*家用厨房电器具*苏泊尔电热水瓶SW-50S56A5L容量电水壶多段温控电热水壶304不锈刚保温除氯烧水壶",
"ggxh": "SW-50S56A",
"sl": "1",
"jldw": "台",
"dj": "215.044247787611",
"je": 215.04,
"slv": 0.13,
"ysslv": "13%",
"se": 27.96,
"ysse": "27.96"
},
{
"mc": "*家用厨房电器具*苏泊尔电水壶",
"ggxh": "SW-50S56A",
"sl": "1",
"jldw": "台",
"dj": "215.044247787611",
"je": 215.04,
"slv": 0.13,
"ysslv": "13%",
"se": 27.96,
"ysse": "27.96"
},
{
"mc": "*家用厨房电器具*苏泊尔电水壶",
"ggxh": "SWF17S26A",
"sl": "9",
"jldw": "台",
"dj": "94.6902654867257",
"je": 852.21,
"slv": 0.13,
"ysslv": "13%",
"se": 110.79,
"ysse": "110.79"
},
{
"mc": "*家用清洁电器具*莱克除",
"ggxh": "WB73",
"sl": "2",
"jldw": "台",
"dj": "646.902654867257",
"je": 1293.81,
"slv": 0.13,
"ysslv": "13%",
"se": 168.19,
"ysse": "168.19"
}
],
"pageCount": "2",
"pageNumber": "1"
},
{
"fplx": "0920",
"jd": 0,
"wz": "0,0,595,397",
"fpxflx": "其他",
"fwlx": "",
"company_seal": "0",
"imageSize": "595,397",
"page": 1,
"title": "电子发票(增值税专用发票)",
"jzdw": "国家税务总局",
"province": "",
"city": "",
"qrcode": [
"01,31, ,23312000000007781965,21573.75,20230316, ,BCA9"
],
"fpdm": "",
"fphm": "23312000000007781965",
"kprq": "2023-03-16 00:00:00",
"jym": "",
"xfsbh": "91310113MA1GMT8R4G",
"xfmc": "上海斐溢智能科技有限公司",
"gfsbh": "91310000734574775Q",
"gfmc": "西域智慧供应链（上海）股份公司",
"je": 19091.81,
"se": 2481.94,
"jshj": 21573.75,
"jshjcn": "贰万壹仟伍佰柒拾叁圆柒角伍分",
"bz": "PO详见附件",
"kpr": "袁程程",
"skr": "",
"fhr": "",
"qdbq":"", --全电票标签（建筑服务，货物运输服务，不动产经营租赁服务，旅客运输服务）
"jzbz":"" --建筑标志，是否为建筑标志,仅专用建筑发票返回此字段值。1为建筑专用发票
"pageCount": "2",
"pageNumber": "2"
}
]
}
}
//海关缴款书识别返回结果示例
{
"result":{
"success":true,
"req_id":"1f37c66e43b9435db272d3cb2bc88df9",
"timestamp":1681378148978,
"time":40355
},
"value":{
"data":{
"barcode":null, --条形码
"bgdbh":"01********************83", --报关单编号
"bzbz":"EUR", --备注币种
"bzjshlv":"6.8928", --备注计税汇率
"city":null, --市
"company_seal":null, --是否有公司印章（0：没有；1：有）
"dq":null, --地区
"dzbz":null, --电子标志
"fplx":"17", --发票类型
"fpxflx":"其他", --发票消费类型
"fwlx":null, --服务类型
"hgkadm":"0101", --海关口岸代码
"hgmc":"**机场", --海关名称
"hjje":"3972.48", --合计金额
"hjjecn":"叁仟玖佰柒拾贰圆肆角捌分", --合计金额中文大写
"htpwh":"AS********-91", --合同（批文）号
"imageSize":"995,685", --图片分辨率
"jd":0, --顺时针旋转角度
"jkdwkhyh":"**银行", --缴款单位(人)开户银行
"jkdwmc":"江苏****公司", --缴款单位(人)公司名称
"jkdwzh":"48********99", --缴款单位(人)帐号
"jkqx":"2022年6月15日前", --缴款期限
"jkshm":"01***************-A01", --缴款书号码
"jksxx":[ --缴款书信息
{
"hwmc":"橡胶密封环", --货物名称
"jldw":"千克", --计量单位
"sh":"1.4016931000", --税号
"skje":"1679.66", --税款金额
"sl":"4.00", --数量
"slv":"8.0000", --税率
"wsjg":"20996.00" --完税价格
},
{
"hwmc":"",
"jldw":"千克",
"sh":"2.3926901000",
"skje":"2292.82",
"sl":"2.50",
"slv":"10.0000",
"wsjg":"22928.00"
}
],
"jzdw":null, --监制单位
"km":"进口关税", --科目
"page":0, --页码
"province":null, --省份
"qrcode":null, --二维码， 返回信息包含发票代码、发票号码、税前金额、开票日期、校验码
"skgk":"中国***********支行20*****63", --收款国库
"sqdwbh":"11******9Y", --申请单位编号
"srjg":"中**库", --收入机关
"srxt":"海关系统", --收入系统
"tfrq":"2022年05月31日", --填发日期
"title":"海关进口关税 专用缴款书", --标题
"txfbz":null, --通行费标识
"tzdw":"首都**海关", --填制单位
"tzhdh":"02******_STRA********68", --提/装货单号
"wz":"0,0,995,685", --图片位置信息，左上右下位置信息，格式x1,y1,x2,y2
"ysgj":"", --运输工具（号）
"ysjc":"中央" --预算级次
},
"datas":null,
"imageUrl":"http://**********************y5BvXpCk%2B4k%3D", --图片url
"single":true, --是否单张发票识别
"success":true --识别是否成功
}
}
//多张发票识别返回结果示例
{
"result":{
"req_id":"7454ccf4fe4249b4ae7304807947b324",
"success":true,
"time":3307,
"timestamp":1648783667313
},
"value":{
"single":false,
"fkBz":"0bf59a6ca5111c8bb1fb0feb7f94e2f0",
"success":true,
"datas":[
{
"xfsbh":"91320********18839",
"company_seal":"1", --是否有公司印章（0：没有；1：有）
"gfmc":"上海****科技有限公司",
"gmfyhzh":"招商银行股份有限公司******12192******0801",
"xsfdzdh":"千*镇**东路**号*号0512-39****04",
"se":35.51,
"skm":"039-09-21*+64>4>-9/448*89<<>,*3>/-3+2/7530742270878+462<+,<5+/308-><854086+/2632+72/-9,17187>27->01422619*6>925>282",
"kprq":"2022-01-10 00:00:00",
"bz":"订单号:2357****0137",
"imageSize":"1248,792",
"skr":"王陆",
"sbbh":"499098825890",
"gfsbh":"91310********EFN5H",
"wz":"0,0,1248,792",
"fpdm":"0320****0511",
"fplx":"10",
"kpr":"汤*丹",
"fhr":"李*",
"fpxflx":"其他", --发票消费类型
"gmfdzdh":"上海市**区**路****号*幢*层*****室173*****710",
"xsfyhzh":"中国建设银行股份有限公司*****支行32201********1511848",
"jd":0,
"jshj":308.68,
"page":0,
"je":273.17,
"xfmc":"昆山*******有限公司",
"hwxx":[
{
"ggxh":"",
"jldw":"",
"dj":"",
"se":35.51,
"ysse":"35.51",
"mc":"(详见项目清单)",
"sl":"",
"je":273.17,
"slv":0.13,
"ysslv":"13%"
}
],
"fphm":"40****20",
"jym":"11764******50494858"
},
{
"fpdm":"032******511",
"wz":"0,0,1248,1670",
"fpxflx":"其他",
"fplx":"910",
"kprq":"2022年01月10日",
"jshj":"273.17",
"jd":0,
"page":1,
"imageSize":"1248,1670",
"title":"销售货物或者提供应税劳务清单",
"fphm":"40****20"
},
{
"xfsbh":"91430********3279B",
"company_seal":"1",
"gfmc":"上海******科技有限公司",
"xsfdzdh":"湖南长沙市**********号188*****005",
"se":31.06,
"skm":"+>/<4+3+4947<497/785+07/3+6,>/0-<9<13+2532421/2/6/88/>/,/4<3-04<6*47-+5+<0/4+599635,/26+6>2-20801<2*5/77/97->5*",
"kprq":"2021-10-18 00:00:00",
"bz":"订单号:226164376441",
"imageSize":"1219,789",
"skr":"梅闰桀",
"sbbh":"661007296754",
"gfsbh":"91310********EFN5H",
"wz":"0,0,1219,789",
"fpdm":"0430****0111",
"fplx":"10",
"kpr":"李*玉",
"fhr":"欧*",
"fpxflx":"其他",
"xsfyhzh":"中国农业银行股份有限公司****支行1807******02754",
"jd":0,
"jshj":269.9,
"page":2,
"je":238.84,
"xfmc":"湖南万佳惠****有限责任公司长沙***分店",
"hwxx":[
{
"ggxh":"",
"jldw":"",
"dj":"",
"se":31.06,
"ysse":"31.06",
"mc":"(详见销货清单)",
"sl":"",
"je":238.84,
"slv":0.13,
"ysslv":"13%"
}
],
"fphm":"70****77",
"jym":"85622******296478807"
},
{
"fpdm":"043******111",
"wz":"0,0,1231,1577",
"fpxflx":"其他",
"fplx":"910",
"kprq":"2021年10月18日",
"jshj":"238.84",
"jd":0,
"page":3,
"imageSize":"1231,1577",
"title":"销售货物或者提供应税劳务、服务清单",
"fphm":"70****77"
},
{
"fpdm":"043******111",
"wz":"0,0,1231,1577",
"fpxflx":"其他",
"fplx":"910",
"kprq":"2021年10月18日",
"jshj":"238.84",
"jd":0,
"page":4,
"imageSize":"1231,1577",
"title":"销售货物或者提供应税劳务、服务清单",
"fphm":"70****77"
}
]
}
}
- 字段说明
| 字段名 | 说明 |
|---|---|
| success | 识别是否成功 |
| data | 发票信息相关字段，参考发票识别返回结果示例及字段说明 |
| datas | 多张发票识别返回结果列表，结构和 data 一样 |
| fplx | 发票类型代码 |
| fpxflx | 发票消费类型 |
| company_seal | 公司印章，0：没有，1：有 |
| jd | 旋转角度，顺时针旋转的角度 |
| wz | 图片位置信息，多张发票识别时返回，左上右下位置信息，格式：x1,y1,x2,y2 |
| page | 页码，从0开始，0为第一页，以此类推 |
| imageSize | 图片大小，当文件有多页时为当页的尺寸大小,格式：长，宽 |
| code | 识别失败编码 |
| message | 识别失败信息 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| ParameterIsNull | 发票识别参数不能为空 | 请核对参数是否符合规范 |
| ImageIsNull | 发票图片信息不能全部为空（文件、文件链接、Base64数据） | 请核对发票信息参数是否为空 |
| ImageIsInvalid | 发票图片信息无效 | 请核对发票文件：1.是否是损坏的图片; 2. 是否是不支持的图片格式; 3.是否图片大小超过限制; 使用imageUrl参数时: 1.检查图片url是否正确；2.检查图片能否正常下载,图片下载timeout为20秒； |
| NotSupport | 暂不支持的发票类型 | 请核对发票类型是否属于支持识别的类型 |
| Failed | 发票识别失败，请联系管理员 | |
| ServerError | 服务器异常，请稍后重试 |
医疗票据识别（Beta版）
1、接口描述
该接口用于医疗票据识别
2、接口地址
POST /v1/FP/sb HTTP/1.1
3、请求参数
- 参数说明
请求参数为 JSON 格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| ylpj | Boolean | 是 | 是否医疗票据识别，固定值true。 |
| imageFile | File | 否 | 医疗票据图片文件 |
| imageData | String | 否 | 发票图片 Base64 数据，最大不能超过5MB |
医疗票据图片信息相关参数imageFile、imageData只需传入一项 医疗票据仅支持单张识别
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
//发票图片 Base64 数据方式
{
"ylpj":true,
"imageData":"/9j/4AAQSk*********************************************************"
}
//发票图片文件方式
{
"ylpj":true,
"imageFile": xx
}
4、返回结果
- 返回结果
返回结果为JSON格式
{
"result":{
"req_id":"293a9571399341c0966b6227b3091d43",
"success":true,
"time":6243,
"timestamp":1636637357966
},
"value":{
"single":true, --单张医疗票据识别标识
"fkBz":"e5ed12432300ed5d1eb1f64c7f3a9d54eb98363693632f08e313e7aecf8bbca7",
"data":{ --单张医疗票据识别返回结果数据
"jkr":"陈**", --缴款人
"fpdm":"44****21", --票据代码
"fplx":"ylsfdzpj", --发票类型
"kprq":"2021-09-02", --开票日期
"je":"17,472.26", --金额
"fphm":"004****639", --票据号码
"jym":"cb**e3" --校验码
},
"ylpj":true, --医疗票据识别标识
"success":true
}
}
识别失败示例
{
"result":{
"req_id":"d3675e1eb11c4e4f949cd15027ff75a7",
"success":true,
"time":340,
"timestamp":1636638727412
},
"value":{
"single":true,
"code":"ImageIsNull",
"ylpj":true,
"success":false,
"message":"发票图片信息不能全部为空（图片链接、Base64 数据）"
}
}
{
"result":{
"req_id":"dd96fdf46bb54ae1b398f1ac9d49aa31",
"success":true,
"time":879,
"timestamp":1636639048196
},
"value":{
"single":true,
"fkBz":"ad0f712adf9e4fe7c5fadbf894077017fbc86270bfd955e66fb938be8f58a991",
"ylpj":true,
"success":false,
"message":"识别结果为空"
}
}
- 字段说明
| 字段名 | 说明 |
|---|---|
| success | 识别是否成功 |
| data | 医疗票据信息相关字段，参考发票结构说明、其他票据 |
| datas | 多张发票识别返回结果列表，结构和 data 一样 |
| fplx | 发票类型代码 |
| code | 识别失败编码 |
| message | 识别失败信息 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| ParameterIsNull | 发票识别参数不能为空 | 请核对参数是否符合规范 |
| ImageIsNull | 发票图片信息不能全部为空（文件、文件链接、Base64数据） | 请核对发票信息参数是否为空 |
| ImageIsInvalid | 发票图片信息无效 | 请核对发票文件：1.是否是损坏的图片; 2. 是否是不支持的图片格式; 3.是否图片大小超过限制; 使用imageUrl参数时: 1.检查图片url是否正确；2.检查图片能否正常下载,图片下载timeout为20秒； |
| NotSupport | 暂不支持的发票类型 | 请核对发票类型是否属于支持识别的类型 |
| Failed | 发票识别失败，请联系管理员 | |
| ServerError | 服务器异常，请稍后重试 |