增值税发票识别
一、接口描述
1. 功能描述
天壤智能增值税识别,是天壤OCR产品之一。融合先进的智能检测和识别技术,实现普通增值税发票和专用增值税发票关键字段的秒级识别和录入,支持自然场景下的手机、扫描仪等拍摄工具的图像,支持阴影、反光、高亮、模糊、角度旋转等特殊高精度识别,支持证照主体的切分和分类。识别准确率达95%以上,基于场景数据训练后准确率可以持续迭代和提升。
2. 接口数据要求
图片格式: base64编码
图片类型: jpg/jpeg/png
图片大小: 小于5M
图片尺寸: 最小300x300
3. 接口使用:
平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。
在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程。用户需要使用营业执照图片base64编码去做请求,使用其他图片的base64编码请求成功时也会加入计费。
二、请求说明
1. 接口地址:
https://aiapi.jd.com/tianrang/vat_invoice
2. 请求方式
POST
3. 请求参数
(1)query请求参数
公共请求参数
名称 |
类型 |
必填 |
示例值 |
描述 |
appkey |
String |
是 |
21d2b762ecb86593f9668526920f46c |
您的appkey,可在买家中心控制台中获取 |
timestamp |
long |
是 |
1541491668961 |
请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign |
String |
是 |
6e148773a0337a8f2200ba90d445f083 |
签名,根据规则MD5(sectetkey+timestamp) |
名称 |
类型 |
必填 |
示例值 |
描述 |
Content-Type |
String |
false |
application/json |
application/json |
(3)body请求参数
名称 |
类型 |
必填 |
示例值 |
描述 |
media_id |
string |
true |
图像Base64编码值,去掉图片头"data:image/png;base64,", {"media_id":"4AAQSk..."}(由于过长,不给出示例) |
图片base64编码 |
(4)请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的2接口使用
返回说明
1、返回参数
(1)公共返回参数
名称 |
类型 |
示例值 |
描述 |
code |
string |
1000 |
参见下方错误码-系统级错误码 |
charge |
boolean |
false 或 true |
false:不扣费, true:扣费 |
remainTimes |
long |
1305 |
剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds |
long |
1223456 |
剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg |
string |
查询成功 |
参见下方错误码-系统级错误码 |
result |
object |
{...} |
查询结果 |
(2)业务返回参数
名称 |
类型 |
示例值 |
描述 |
code |
number |
0 |
状态code |
requestId |
String |
98a39e53-84d4-448e-9081-29f64a6cd984 |
请求id |
message |
String |
success |
返回信息 |
data |
Object |
{...} |
data |
data字段说明
名称 |
类型 |
示例值 |
描述 |
InvoiceNum |
string |
72561866 |
发票号码 |
InvoiceCode |
string |
033001800104 |
发票代码 |
InvoiceDate |
string |
2018-09-20 |
开票日期 |
PurchaserName |
string |
|
购买方日期 |
PurchaserRegisterNum |
string |
|
购买方纳税人识别号 |
PurchaserAddressPhone |
string |
|
购买方地址、电话 |
PurchaserBankAcct |
string |
|
购买方开户行及账号 |
SellerName |
string |
|
销售方名称 |
SellerRegisterNum |
string |
|
销售方纳税人识别号 |
SellerAddressPhone |
string |
|
销售方地址及电话 |
SellerBankAcct |
string |
|
销售方开户行及账号 |
TotalAmount |
string |
45452.59 |
合计金额 |
TotalTax |
string |
7272.41 |
合计税额 |
AmountInFiguers |
string |
52725.00 |
价税合计(小写) |
AmountInWords |
string |
伍万贰仟柒佰贰拾伍圆整 |
价税合计(大写) |
Title |
string |
浙江增值税普通发票 |
标题 |
Commodities |
[{...}] |
7272.41 |
货物明细 |
Commodities字段说明
名称 |
类型 |
示例值 |
描述 |
CommodityName |
string |
医疗仪器器械环形标测导管 |
货物名称 |
CommodityType |
string |
DLN1215CT |
规格型号 |
CommodityUnit |
string |
根 |
单位 |
CommodityQuantity |
string |
3 |
数量 |
CommodityUnitPrice |
string |
15150.862069 |
单价 |
CommodityAmount |
string |
45452.59 |
金额 |
CommodityTaxRate |
string |
16% |
税率 |
CommodityTax |
string |
7272.41 |
税额 |
2.返回示例
{
"code": 0,
"message": "success",
"data": {
"InvoiceNum": "1112311",
"InvoiceCode": "1111111",
"InvoiceDate": "3033-03-30",
"PurchaserName": "某某测试医院",
"PurchaserRegisterNum": "12330000750003222E",
"PurchaserAddressPhone": "某某测试地址0111-22222222",
"PurchaserBankAcct": "某测试银行1101010011011212106",
"SellerName": "测试医疗科技有限公司",
"SellerRegisterNum": "11111322223344010121",
"SellerAddressPhone": "测试地址112室 0111-2313113131",
"SellerBankAcct": "测试地址1111020110003211122",
"TotalAmount": "45452.59",
"TotalTax": "7272.41",
"AmountInFiguers": "52725.00",
"AmountInWords": "伍万贰仟柒佰贰拾伍圆整",
"Commodities": [
{
"CommodityName": "*医疗仪器器械*环形标测导管",
"CommodityType": "DLN1215CT",
"CommodityUnit": "根",
"CommodityQuantity": "3",
"CommodityUnitPrice": "15150.862069",
"CommodityAmount": "45452.59",
"CommodityTaxRate": "16%",
"CommodityTax": "7272.41"
}
],
"Title": "浙江增值税普通发票"
},
"requestId": "52BC7657-9FE4-4C12-B00D-9F86C211AF70"
}
四、错误码信息
1.系统级错误码
详见返回码
2.业务错误码
错误号(code) |
错误信息(message) |
描述 |
0 |
success |
成功 |
1000 |
body error |
请求主体错误 |
1001 |
param error |
请求参数错误 |
1002 |
content type error |
Content-Type错误 |
1003 |
image not exist |
没有找到图片文件 |
1004 |
image size error |
图片大小错误 |
1005 |
image format error |
图片类型错误 |
1006 |
invalid signature |
无效的签名 |
1007 |
body size error |
body大小错误 |
1008 |
no authorization |
没有认证权限 |
2000 |
server unknown error |
服务端未知错误 |
2001 |
server timeout |
服务端超时 |
2003 |
no content recognition |
没有识别出内容 |
2004 |
validate data error |
校验识别数据错误 |
3000 |
remote server error |
服务端远程服务错误 |
4000 |
base server error |
基础服务错误 |