增值税发票识别

一、接口描述

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)

(2)header请求参数

名称 类型 必填 示例值 描述
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 基础服务错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""