发票识别增强版

一、接口描述

1. 功能描述

​ 发票识别包括识别增值税普通发票、增值税专用发票和电子专用发票。目前接口支持发票代码、发票号码、开票日期、发票金额、发票税额、价税合计、校验码(增值税普通发票)、购买方名称、购买方税号、购买方地址、购买方开户行及账号、销售方名称、销售方税号、销售方地址、销售方开户行及账号、收款人、复核人、开票人等字段的提取

接口支持可供调用方选择的发票验真功能

接口支持对各种方向的发票图像进行结构化解析**

二、请求说明

1. 接口地址 :

https://aiapi.jd.com/jdai/ocr_invoice_plus

2. 请求方式:

 post

3. 请求参数

(1)query请求参数

公共请求参数

名称 类型 必填 示例值 描述
appkey string 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign string 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)

(2)header请求参数

业务请求参数

名称 类型 必填 示例值 描述
Content-Type string application/json 内容类型

(3)body请求参数

业务请求参数

名称 类型 示例值 描述
body string ["图片的Base64格式数据"] 图片的Base64格式数据,不包含前缀:data:image/jpeg;base64,

三、返回说明

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)业务返回参数

名称 类型 示例值 描述
uuid String 请求标识号
status string 结果状态码,见业务错误码
invoiceType string 发票类型
checkState string 0 验真状态,"-1":调用验真接口失败;"0":校验通过;"1":超过该张票当天查验次数;"2":一级字段不完整,无法验真;"3":错误请求;"4":超过请求量最大值;"5":查询发票不规范;"6":查验异常;"7":参数长度不正确;"8" :参数为空;"9":查验未完成;"10":日期当天不能查验;"11":开票金额:不合法的格式;"12":检验码:不能为空;"13":超过一年的不能查验;"14":检验码:不合法的长度;"15":没有查验权限;"16":发票信息不一致;"17":所查发票不存在;"18":校验没有开启
IsEInvoice string 是否电子发票
invoiceCode string 发票代码
invoiceNo string 发票号码
buyerName string 购买方名称
buyerTaxNo string 购买方税号
buyerAddress string 购买方地址
buyerAcount string 购买方开户行及账号
salerName string 销售方名称
salerTaxNo string 销售方税号
salerAddress string 销售方地址
salerAcount string 销售方账号
invoiceDate string 开票日期
verifyCode string 校验码
invoiceAmount string 发票金额
taxAmount string 发票税额
totalAmount string 价格合计
remark string 备注
invoiceStatus string 发票状态
legalizeState string 认证状态
legalizeDate string 认证日期
payee string 收款人
reviewer string 复核人
drawer string 开票人
departCity string 始发站(火车票专用)
arriveCity string 终点站(火车票专用)
trainNumber string 车次(火车票专用)
passenger string 乘车人(火车票专用)
detaillists List<Detaillist> 商品详细信息

Detaillist

名称 类型 示例值 描述
detailNo String 明细编号
goodName String 货物名称
model String 规格
unit String 单位
num String 数量
unitPrice String 单价
detailAmount String 金额
taxRate String 税率
taxAmount String 税额

2、返回示例

{
    "code": "10000",
    "charge": false,
    "remainTimes": 4998,
    "remainSeconds": -1,
    "msg": "查询成功",
    "result": {
        "arriveCity": "",
        "buyerAcount": "",
        "buyerAddress": "",
        "buyerName": "",
        "buyerTaxNo": "",
        "checkState": "18",
        "departCity": "",
        "detaillists": [
            {
                "detailAmount": "",
                "detailNo": "",
                "goodName": "无",
                "model": "",
                "num": "",
                "taxAmount": "",
                "taxRate": "",
                "unit": "",
                "unitPrice": ""
            },
            {
                "detailAmount": "",
                "detailNo": "",
                "goodName": "三星(SAMSUNG)S24E360HL23.6英",
                "model": "",
                "num": "",
                "taxAmount": "",
                "taxRate": "",
                "unit": "",
                "unitPrice": ""
            },
            {
                "detailAmount": "",
                "detailNo": "",
                "goodName": "寸LED背光显示器",
                "model": "",
                "num": "",
                "taxAmount": "",
                "taxRate": "",
                "unit": "",
                "unitPrice": ""
            },
            {
                "detailAmount": "",
                "detailNo": "",
                "goodName": "折扣(4.907%)",
                "model": "",
                "num": "",
                "taxAmount": "",
                "taxRate": "",
                "unit": "",
                "unitPrice": ""
            }
        ],
        "drawer": "京东商城",
        "invoiceAmount": "828.20",
        "invoiceCode": "111001571071",
        "invoiceDate": "1212",
        "invoiceNo": "39788264",
        "invoiceStatus": "",
        "invoiceType": "04",
        "isEInvoice": "true",
        "legalizeDate": "",
        "legalizeState": "",
        "passenger": "",
        "payee": "京东商城",
        "remark": "",
        "reviewer": "",
        "salerAcount": "",
        "salerAddress": "北京市北京经济技术开发区科创十四街99号2号楼B168室010-56754036",
        "salerName": "北京京东世纪信息技术有限公司",
        "salerTaxNo": "110192562134916",
        "status": "OK",
        "taxAmount": "140.80",
        "totalAmount": "969.00",
        "trainNumber": "",
        "uuid": "c0178b82ab9265c4f40666a86c2523b8",
        "verifyCode": "49507382490687444615"
    }
}

四、错误码

1.系统级错误码

详见返回码

2.业务错误码

业务错误码(status) message 说明
OK "OK" 成功
UNAUTHORIZED "UNAUTHORIZED" 授权错误
IMAGE_NOT_EXISTS "IMAGE_NOT_EXISTS" 图片不存在
INCORRECT_IMAGE "INCORRECT_IMAGE" 无效图片
ALGORITHM_ERROR "ALGORITHM_ERROR" 算法执行错误
TIME_OUT "TIME_OUT" 运算超时
OUT_OF_RESOURCE "OUT_OF_RESOURCE" 资源不够
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-08-06 11:53:45

results matching ""

    No results matching ""