接口文档 - 星云税融API

接口文档

文档 / 票据查验 / 查验扩展 / 上传文件查验

票据查验 - 上传文件查验

增值税/数电票/财政票据/区块链发票查验

查验扩展

上传文件查验

上传文件查验(仅限增值税发票)。支持xml/ofd/pdf格式,文件大小<500KB。企享云先从文件识别四要素再查验,返回全票面+fileUrl。适合费控报销场景:客户只有PDF/OFD文件,无需手工录入fpdm/fphm/kprq等

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/verify/upload

请求参数

参数名	类型	必填	说明
fileName	String	是	文件名+后缀,目前支持pdf/ofd/xml。例:test.pdf
fileData	String	是	文件内容base64编码,原始文件需<500KB

请求示例

JSON

{
    "fileName": "test.pdf",
    "fileData": "JVBERi0xLjQKJaqr..."
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	查验结果
data[].success	Boolean	查验是否成功
data[].fileUploadCy	Boolean	是否文件上传查验=true
data[].fileUrl	String	文件存储URL(企享云侧)
data[].fplx	String	识别出的发票类型
data[].fpdm	String	识别出的发票代码
data[].fphm	String	识别出的发票号码
data[].kprq	String	识别出的开票日期
data[].je	Number	识别出的金额
data[].jym	String	识别出的校验码
data[].dq	String	地区码
data[].data	Object	查验成功返回全票面(同zzsfpCy),失败返回识别结果

响应示例

JSON

{
    "code": "2000",
    "reqId": "1f7d8d89b55641fe8f4075f2f01119d3",
    "success": true,
    "data": [
        {
            "success": true,
            "fileUploadCy": true,
            "fplx": "10",
            "dq": "11",
            "fpdm": "011002200811",
            "fphm": "95988841",
            "kprq": "2023-02-15 00:00:00",
            "je": 1960.26,
            "jym": "509791",
            "fileUrl": "http:\/\/qxy-oss...\/xxx.pdf",
            "times": 2,
            "data": {
                "xfmc": "北京XX科技有限公司",
                "xfsbh": "9111XXXXFB09",
                "gfmc": "XX有限公司",
                "gfsbh": "91XXXXXXXX90",
                "je": 1960.26,
                "se": 28.14,
                "jshj": 1988.4,
                "fpztDm": "0",
                "hwxx": [
                    {
                        "mc": "*运输服务*客运服务费",
                        "je": 1066.24,
                        "slv": 0
                    }
                ]
            }
        }
    ]
}

如需接入支持，请联系技术团队 | 注册账号