接口描述

进行发票文件的OCR识别及查验，仅会返回第一张发票

适用票种

1普通电子发票 2.电子发票专票 3.普通纸质发票 4.专用纸质发票 5.普通纸质卷票 12.机动车 13.二手车 15.通行费 26.数电票（普通发票） 27.数电票（增值税专用发票） 28.数电票（航空运输电子客票行程单） 29.数电票（铁路电子客票）

接口请求

• 支持输入文件：图片/PDF/OFD
• 请求方式：POST
• 请求头header：Content-Type=application/json
• 请求数据结构: base64字符文件（将发票文件转换为base64字符串）
• 请求地址: /m3/bill/invoice/img/Check/info?access_token=accessToken&type={文件类型}

重要提示

:::tip
单个文件大小限制在8Mb以内，超出大小需要进行处理
1、PDF/OFD文件，可进行按页切割，转为图片
2、图片文件超出大小的，可以进行压缩后调用
3、26.数电票（普通发票） 27.数电票（增值税专用发票） 28.数电票（航空运输电子客票行程单） 29.数电票（铁路电子客票） 不支持图片识别，请使用发票原件
:::

请求示例

    //测试环境: https://api-dev.piaozone.com/test
    //正式环境: https://api.piaozone.com
    private static final String HOST = "https://api-dev.piaozone.com/test";

    public static void main(String[] args) {
        // 替换为你自己的accessToken
        String accessToken = "YOUR_ACCESS_TOKEN";
        //发票文件
        File file = new File("YOUR FILE");
        String fileName = file.getName();
        //文件后缀，pdf/ofd/jpg/png...
        String fileType =  fileName.substring(fileName.lastIndexOf(".") + 1).toLowerCase();
        //文件转base64
        String base64 = Base64.encode(file);
        // 构建请求URL
        String urlStr = HOST + "/m3/bill/invoice/img/Check/info?access_token=" + accessToken + "&type=" + fileType;
        //发送请求
        String response = HttpUtil.post(urlStr, base64);
        //进行业务处理
        ...

    }

数据描述：

1、识别成功、查验成功时，返回的是查验数据
2、识别成功、查验失败时，返回的是识别数据
3、识别失败时，返回对应错误

返回

返回数据结构示例：Json

{
    "errcode": "{状态码}",
    "description": "{描述}",
    "data":"{发票结构化数据}"
}

返回状态码(errcode)见：《返回状态码》的附录2

返回发票结构化数据(data)见：发票数据规范