开放平台API

进项票据OCR识别接口

POST/post/rest/invoice/dii

此接口支持获取企业自身的进项发票数据（含：发票的号码，代码，开票日期，发票状态，购销方信息，备注，金额，税额，商品，规格型号，单位，单价，数据等信息），帮助企业及时拿到发票数据，提升工作效率，同时规避税务的风险。

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

authorize

object

安全凭证

必需

appSecId

string

密钥ID

必需

平台随机生成

appSec

string

签名串

必需

根据密钥ID和KEY生成的签名串

globalInfo

object

接口信息

必需

appId

string

接口ID

必需

例：JXFP

version

string

接口版本号

必需

例：V1.0

interfaceCode

string

接口编码

必需

例：INVOICE.GET

enterpriseCode

string

企业编码

必需

dataExchangeId

string

接口数据加密

必需

例：默认值dataExchangeId

data

object

获取条件参数

必需

由获取条件参数通过用Base64加密生成的字符串

isCheck

string

是否查验

必需

默认为1
1：查验，
0：不查验

dNo

string

报销单据号

必需

fileName

string

文件名

必需

支持的图片类型: jpg, jpeg, png及pdf(pdf只支持识别第一页内容)，图片转换的base64字符串最大支持5M,新增支持ofd格式文件

base64Content

string

文件base64字符串

必需

文件是二进制字符串，并进行Base64加密处理（无需加密）。

{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE995C39FFC3DFE17FB",
        "appSec": "PIomx6Gqs3MPlaWYiU9NiWnCokk="
    },
    "globalInfo": {
        "appId": "JXFP",
        "version": "V1.0",
        "interfaceCode": "INVOICE.OCR",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "W3siaXNDaGVjayI6IjEiLCJkTm8iOiIyMDIzMTIx..."
}

//data加密前的参数
[
    {
        "isCheck": "1",
        "dNo": "202312140001",
        "fileName": "当当发票7674539945139058536.pdf",
        "base64Content": "JVBERi0xLjcKJaGzxdcKMSAwIG9iag0K..."
    }
]

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

data

object

返回参数

必需

由返回的参数通过用Base64加密生成的字符串

fileName

string

文件名称

必需

dNo

string

单据号

必需

success

string

识别结果代码

必需

识别成功：true
识别失败：false

datas

array [object {7}]

识别票据列表数据

必需

cyResult

string

发票查验结果

必需

查验成功：true
查验失败：false
不查验：notDone

mnum

integer

识别发票数量

必需

msg

string

识别结果信息

可选

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回信息

必需

例：处理成功


{
    "data": "eyJyZXN1bHQiOlt7ImJzd2pVcmwiOiIgIiwiYnV5ZXJUYXhObyI6IjkxMTEwMDAwMT....",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}

//data加密前的数据
{
    "result": [
        {
            "bswjUrl": " ",
            "buyerTaxNo": "91110000100006389A",
            "checkCode": " ",
            "currentTaxPeriod": " ",
            "detailList": [
                {
                    "cmcode": " ",
                    "cmggxh": " ",
                    "cmname": "*鉴证咨询服务*检验费",
                    "hNo": "1",
                    "je": "3204",
                    "pri": "3204",
                    "qnt": "1",
                    "se": "192.24",
                    "sl": "6",
                    "unit": "项"
                }
            ],
            "fpDm": null,
            "fpNo": "22312000000001242403",
            "fpcc": " ",
            "fpzlDm": "31",
            "invoiceAmount": "3204",
            "invoiceDate": "2022-11-01",
            "invoiceStatus": "0",
            "legalizeBlongDate": " ",
            "legalizeDate": null,
            "legalizeState": " ",
            "legalizeType": " ",
            "note": "IQB 241929",
            "qdbz": " ",
            "rn": 1,
            "rzlx": "0",
            "salerAccNo": "1001189709006809947",
            "salerKhh": " ",
            "salerLxdh": "671",
            "salerName": "必维毕法克检验（上海）有限公司",
            "salerTaxNo": "9131000076164787XD",
            "salerZcdz": "上海市杨浦区伟德路6号1302-11室58352011×",
            "sfdbts": " ",
            "taxAmount": "192.24",
            "taxRate": "6",
            "totalAmount": null
        }
    ],
    "totalRows": 1
}

最后修改时间： 1 年前