接口文档 - 星云税融API

接口文档

文档 / 数电开票 / 版式文件与交付

数电开票 - 版式文件与交付

蓝字/红字发票开具、额度查询等

版式文件与交付

下载版式文件(销项)

下载已开发票的版式文件(PDF/OFD/XML)。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/format/download

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.fphm	String	是	发票号码
data.bswjLx	String	否	版式文件类型：PDF/OFD/XML

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fphm": "23312000000043000001",
        "bswjLx": "PDF"
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.fileList	Array	文件列表
data.fileList[].fileType	String	文件类型
data.fileList[].fileUrl	String	下载URL

响应示例

JSON

{
    "reqId": "issue015",
    "code": "2000",
    "success": true,
    "data": {
        "fileList": [
            {
                "fileType": "PDF",
                "fileUrl": "https:\/\/oss.example.com\/invoice\/xxx.pdf"
            }
        ]
    }
}

税局邮箱交付

通过税局邮箱交付发票。将开好的发票通过税局邮箱发送给购方。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/email/deliver

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.fphm	String	是	发票号码
data.email	String	是	接收邮箱地址

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fphm": "23312000000043000001",
        "email": "customer@example.com"
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.result	Boolean	发送结果

响应示例

JSON

{
    "reqId": "issue016",
    "code": "2000",
    "success": true,
    "data": {
        "result": true
    }
}

下载版式文件(废弃)

下载版式文件(已废弃)。请使用 issue-format-download 替代。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/issue/format/deprecated

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.fphm	String	是	发票号码

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fphm": "23312000000043000001"
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "data": []
}

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