增值税发票快速识别
  • 221
  • 4274

发票识别

增值税发票快速识别按次计费正常服务
  • 该接口申请即送20次测试调用额度
  • 价格:900天豆/次(≤0.09元)
增值税专票及普票快速识别,支持图片和PDF文件。其中imgdata应该传递图片的base64编码、imgurl应该为没有防盗链限制且带宽质量稳定的图片的url地址、pdfdata和ofddata应该为文件的base64编码。以上方式任选其一,文件不超过5M。

接入点列表:

  • 发票识别
▼ 接口信息

增值税发票识别,支持图片和PDF及OFD文件

  • 接口地址:https://apis.tianapi.com/ocrinvoice/index
  • 请求示例:https://apis.tianapi.com/ocrinvoice/index?key=你的APIKEY&imgdata=img_base64
  • 支持协议:http/https
  • 请求方式:get/post
  • 返回格式:utf-8 json
▼ 请求参数

post方式请求时,enctype应为application/x-www-form-urlencoded

上传文件二进制数据流方式,enctype必须为multipart/form-data

参数url、base64中有特殊字符时,建议对值urlencode编码后传递

名称类型必须示例值/默认值说明
keystring您自己的APIKEY(注册账号后获得)API密钥
imgdatastringimg_base64图片base64(与imgurl、pdfdata、ofddata四选一)
imgurlstringhttps://www.tianapi.com/static/img/ocr/invoice.jpg图片url地址
pdfdatastringpdf_base64pdf文件base64
ofddatastringofd_base64ofd文件base64
▼ 返回示例

接口数据样例仅作为预览参考,请以实际测试结果为准

旧域名返回的json结构和现在略有不同,请点击此处查看说明

	
	

成功调用,code=>200并产生计费:

错误调用,查看接口错误码释义:

▼ 返回参数

公共参数指所有接口都会返回的参数,应用参数每个接口都不同

名称类型示例值说明
公共参数
codeint200状态码
msgstringsuccess错误信息
resultobject{}返回结果集
应用参数
typestring电子普通发票发票类型
typeorgstring广东增值税电子普通发票发票名称
xftypestring服务发票消费类型
codestring044001505111发票代码
numberstring93299183发票号码
datestring2020年06月18日开票日期
checkcodestring72338486701337770072校验码,增值税专票无此参数
machinecodestring661616328900机器编号
passwordstring37*2/-3><2*65742041303357*9--发票密码区
total_feecnstring壹佰伍拾玖圆整价税合计(大写)
total_feestring159.00价税合计(小写)
total_taxstring9.00合计税额
total_amountstring150.00合计金额
purchaser_namestring上海觉克信息科技有限公司购方名称
purchaser_registernumstring91310114MA1GTG89XA购方纳税人识别号
purchaser_addressstring购方地址及电话
purchaser_bankstring购方开户行及账号
itemlistarray价税详情
++namestring*信息技术服务*超级会员货物名称
++unitstring单位
++numstring18数量
++pricestring8.33333333单价
++totalfeestring150.00金额
++taxratestring6%税率
++taxfeestring9.00税额
seller_namestring珠海金山办公软件有限公司销售方名称
Seller_registernumstring91440400696437955B销售方纳税人识别号
seller_addressstring珠海市高新区唐家湾镇前岛环路321号...销售方地址及电话
seller_bankstring交通银行珠海分行吉大支行...销售方开户行及账号
payeestring刘晓敏收款人
checkerstring周旭寰复核
notedrawerstring李维开票人
remarksstring备注
▼ 接口价格
充值金额可用次数参考单价
免费20次≈0元/次
10元(10W天豆)111次≈0.0901元/次
100元(110W天豆)1222次≈0.0818元/次
500元(600W天豆)6666次≈0.075元/次
2000元(2600W天豆)28888次≈0.0692元/次
本接口为按次计费类接口,基础价格为900天豆(0.09元)/次,如接口可用次数不足请点此充值天豆(优惠)
▼ 返回状态码

错误信息可能会有所调整,请根据错误状态码(code)进行流程判断

错误状态码错误信息解释帮助
100内部服务器错误报此错误码请及时反馈或等待官方修复
110当前API已下线接口已下线无法使用,可关注相关通知
120API暂时维护中接口暂时关闭维护中,请注意相关公告
130API调用频率超限超过每秒请求数上限,可在控制台-接口管理中查询
140API没有调用权限请检查是否自行在接口管理中停用或被禁用了该接口
150API可用次数不足免费类接口套餐超限或计次类接口余额不足,点此查看说明
160账号未申请该API请先在接口文档页面申请该接口,点此查看说明
170Referer请求来源受限设置了Referer白名单,但来源Referer不在白名单内
180IP请求来源受限设置了IP白名单,但来源IP不在白名单内
190当前key不可用通常为账号无效,此状态无法恢复
230key错误或为空请检查apikey是否填写错误,点此查看帮助
240缺少key参数请检查是否传递了key参数或者编码格式是否符合要求
250数据返回为空数据查询或转换失败,请检查输入值或注意中文编码问题
260参数值不得为空请检查关键参数是否传递了空值
270参数值不符合要求参数值不符合基本格式要求,点此查看说明
280缺少必要的参数缺少必填的参数,请根据接口文档检查
290超过最大输入限制参数值超过输入范围,请查看接口文档的说明
错误码1开头的是系统级错误,2开头的是用户级错误,其中200表示请求成功处理并计费。
▼ 参考代码

此处代码仅演示关键请求片段,实际使用请根据具体环境修改

如需深入学习参考,可点击此处查看部分第三方完整开源项目

活动推荐EXERCISE 更多>

开通会员专享福利
工单 客服