星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票认证

发票认证

进项认证、勾选、统计确认

税款所属期
3 个接口
进项数据采集
19 个接口
发票勾选
16 个接口
统计确认
7 个接口
进项数据取数
2 个接口
异步任务回调
1 个接口

税款所属期

获取税款所属期

获取当前税款所属期。开始勾选认证前必须先获取所属期，确保在正确的期间内操作。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/period/get

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 账号ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.skssq String 当前税款所属期，yyyy-MM
data.kssj String 所属期开始日期
data.jssj String 所属期结束日期

响应示例

JSON 
{
    "reqId": "auth001",
    "code": "2000",
    "success": true,
    "data": {
        "skssq": "2026-03",
        "kssj": "2026-03-01",
        "jssj": "2026-03-31"
    }
}

更新税款所属期

更新税款所属期。异步接口，切换到指定所属期后才能进行该期的勾选操作。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/period/update

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.skssq String 是 目标税款所属期，yyyy-MM

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "skssq": "2026-04"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth002",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933248"
    }
}

更新税款所属期任务结果

更新税款所属期任务结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/period/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933248"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 0=初始化/1=执行中/2=失败/3=成功

响应示例

JSON 
{
    "reqId": "auth013",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933248",
        "status": 3
    }
}

进项数据采集

进项发票采集

进项发票采集

进项发票采集。从税局采集当前所属期的可勾选进项发票。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/income/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
accountId String 否 账号ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth003",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933249"
    }
}

进项发票采集结果查询

查询进项发票采集结果。status=3时采集成功，可通过取数接口获取发票列表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/income/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933249"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID
data.status Integer 0=初始化/1=执行中/2=失败/3=成功
data.fpCount Integer 采集到的发票数量

响应示例

JSON 
{
    "reqId": "auth004",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933249",
        "status": 3,
        "fpCount": 86
    }
}

海关缴款书采集

海关缴款书采集

海关缴款书采集。从税局采集当前所属期的可勾选海关缴款书。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth005",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933250"
    }
}

海关缴款书采集结果查询

查询海关缴款书采集结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933250"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 0=初始化/1=执行中/2=失败/3=成功

响应示例

JSON 
{
    "reqId": "auth006",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933250",
        "status": 3
    }
}

代扣代缴凭证采集

代扣代缴凭证采集

代扣代缴凭证采集。从税局采集可勾选的代扣代缴完税凭证。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/withhold/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth016",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933256"
    }
}

代扣代缴凭证采集结果

代扣代缴凭证采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/withhold/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933256"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 0=初始化/1=执行中/2=失败/3=成功

响应示例

JSON 
{
    "reqId": "auth017",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933256",
        "status": 3
    }
}

待处理农产品采集

待处理农产品采集

待处理农产品采集。采集待处理的农产品发票。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/pending

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth018",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933257"
    }
}

待处理农产品采集结果

待处理农产品采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/pending/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933257"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth019",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933257",
        "status": 3
    }
}

加计扣除农产品采集

加计扣除农产品采集

申请加计扣除农产品采集。采集可加计扣除的农产品发票。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/deduct

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth020",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933258"
    }
}

加计扣除农产品采集结果

加计扣除农产品采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/deduct/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933258"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth021",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933258",
        "status": 3
    }
}

红字发票采集

红字发票采集

申请红字发票采集。采集已开具的红字发票信息。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/red/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth039",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933266"
    }
}

红字发票采集结果

红字发票采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/red/collect/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933266"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth040",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933266",
        "status": 3
    }
}

退税用途确认发票采集

退税用途确认发票采集

申请退税用途确认发票采集。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/refund/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth041",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933267"
    }
}

退税用途确认采集结果

退税用途确认采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/refund/collect/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933267"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth042",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933267",
        "status": 3
    }
}

历史已抵扣信息采集

历史已抵扣信息采集

申请历史已抵扣信息采集。获取历史期间已完成抵扣的发票汇总。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/history/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.skssq String 否 税款所属期，yyyy-MM

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "skssq": "2026-02"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth043",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933268"
    }
}

历史已抵扣信息采集结果

历史已抵扣信息采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/history/collect/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933268"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth044",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933268",
        "status": 3
    }
}

不得抵扣发票

不得抵扣发票查询

不得抵扣发票查询。查看已标记为不得抵扣的发票。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/nodeduct/query

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pageIndex Integer 否 页码
data.pageSize Integer 否 每页条数

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.total Integer 总记录数
data.list Array 不得抵扣发票列表

响应示例

JSON 
{
    "reqId": "auth045",
    "code": "2000",
    "success": true,
    "data": {
        "total": 3,
        "list": [
            {
                "fphm": "23312000000043000010",
                "je": 2000,
                "se": 260,
                "bdDkYy": "用于免税项目"
            }
        ]
    }
}

不得抵扣发票信息采集

申请不得抵扣发票信息采集。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/nodeduct/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth046",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933269"
    }
}

不得抵扣发票采集结果

不得抵扣发票信息采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/nodeduct/collect/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933269"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth047",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933269",
        "status": 3
    }
}

发票勾选

进项发票勾选

发票勾选

发票抵扣勾选。对采集到的进项发票进行勾选操作，勾选后可用于进项税额抵扣。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/deduct/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.gxlx String 是 勾选类型：1=抵扣勾选/2=退税勾选/3=代办退税勾选
data.fpList Array 是 待勾选发票列表
data.fpList[].fphm String 是 发票号码
data.fpList[].fpdm String 否 发票代码
data.fpList[].kprq String 是 开票日期
data.fpList[].je Number 是 金额
data.fpList[].se Number 是 税额
data.fpList[].gxbz String 是 勾选标志：1=勾选/0=取消勾选

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "gxlx": "1",
        "fpList": [
            {
                "fphm": "23312000000043000001",
                "kprq": "2026-01-15",
                "je": 10000,
                "se": 1300,
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth007",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933251"
    }
}

发票勾选结果查询

发票勾选结果查询。查询勾选操作的执行状态及每张发票的勾选结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/deduct/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933251"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 0=初始化/1=执行中/2=失败/3=成功
data.resultList Array 每张发票的勾选结果
data.resultList[].fphm String 发票号码
data.resultList[].success Boolean 勾选是否成功

响应示例

JSON 
{
    "reqId": "auth008",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933251",
        "status": 3,
        "resultList": [
            {
                "fphm": "23312000000043000001",
                "success": true
            }
        ]
    }
}

海关缴款书勾选

海关缴款书勾选

海关缴款书勾选。对采集到的海关缴款书进行勾选操作。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.jksList Array 是 待勾选缴款书列表
data.jksList[].jksbh String 是 缴款书编号
data.jksList[].gxbz String 是 勾选标志：1=勾选/0=取消

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "jksList": [
            {
                "jksbh": "202603XXXXXXXX",
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth009",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933252"
    }
}

海关缴款书勾选结果

海关缴款书勾选结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933252"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态
data.resultList Array 勾选结果

响应示例

JSON 
{
    "reqId": "auth028",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933252",
        "status": 3
    }
}

农产品发票处理

待处理农产品发票

申请农产品发票处理。对待处理的农产品发票执行确认操作。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/invoice

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fpList": [
            {
                "fphm": "23312000000043000005"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth022",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933259"
    }
}

农产品发票处理结果

农产品发票处理结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/invoice/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933259"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth023",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933259",
        "status": 3
    }
}

海关缴款书录入

申请海关缴款书录入

申请海关缴款书录入。将海关缴款书信息录入税局系统。异步接口。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entry

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.jksList Array 是 缴款书信息列表
data.jksList[].jksbh String 是 缴款书编号
data.jksList[].skrq String 是 实缴日期
data.jksList[].se Number 是 税额

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "jksList": [
            {
                "jksbh": "202603XXXXXXXX",
                "skrq": "2026-03-15",
                "se": 8500
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth024",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933260"
    }
}

海关缴款书录入结果

海关缴款书录入结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entry/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933260"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth025",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933260",
        "status": 3
    }
}

已录入缴款书查询

已录入海关缴款书查询。查看已录入到税局的缴款书列表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entered

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth026",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933261"
    }
}

已录入缴款书查询结果

已录入缴款书查询任务结果。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/entered/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933261"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态
data.list Array 缴款书列表

响应示例

JSON 
{
    "reqId": "auth027",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933261",
        "status": 3,
        "list": []
    }
}

代扣代缴凭证勾选

代扣代缴凭证勾选

代扣代缴凭证勾选。对采集到的代扣代缴凭证进行勾选。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/withhold/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pzList Array 是 凭证列表
data.pzList[].pzbh String 是 凭证编号
data.pzList[].gxbz String 是 勾选标志：1=勾选/0=取消

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pzList": [
            {
                "pzbh": "DKDJ202603001",
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth029",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933262"
    }
}

代扣代缴凭证勾选结果

代扣代缴凭证勾选结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/withhold/select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933262"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth030",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933262",
        "status": 3
    }
}

农产品加计扣除勾选

农产品加计扣除勾选

农产品加计扣除勾选。对可加计扣除的农产品发票进行勾选。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/add-select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.fpList Array 是 发票列表
data.fpList[].fphm String 是 发票号码
data.fpList[].gxbz String 是 勾选标志

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "fpList": [
            {
                "fphm": "23312000000043000005",
                "gxbz": "1"
            }
        ]
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth031",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933263"
    }
}

农产品加计扣除勾选结果

农产品加计扣除勾选结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/farm/add-select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933263"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth032",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933263",
        "status": 3
    }
}

注销勾选

注销勾选

申请注销勾选/撤销注销勾选

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/cancel/select

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
sqlx String 是 申请类型：1=注销勾选，2=撤销注销勾选
accountId String 否 登录账户唯一标识，多账号时必传
customReqId String 否 用户标识ID，需保证唯一性
sync Boolean 否 是否同步获取结果，默认false

请求示例

JSON 
{
    "nsrsbh": "91***************3N",
    "sqlx": "1"
}

响应参数

参数名 类型 说明
code String 错误码，2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data String|Object 异步模式返回申请ID；同步模式返回注销勾选结果对象
data.nsrsbh String 纳税人识别号（同步模式）
data.skssq String 税款所属期（同步模式）
data.cljg String 处理结果：1=成功，2=无此税号，3=已申请(注销/撤销注销勾选)，4=已注销/撤销注销勾选，99=其他异常
data.zt Integer 任务状态：1=进行中，2=失败，3=成功
data.zxgxlx String 注销勾选类型：1=注销勾选，2=撤销注销勾选
data.code String 任务失败错误码
data.message String 任务失败错误信息
data.action String 同步超时转异步时返回操作类型：zxgx
data.taskId String 同步超时转异步时返回的任务ID

响应示例

JSON 
{
    "reqId": "1accd95fefc343319163afcc2bb5879c",
    "code": "2000",
    "success": true,
    "message": null,
    "data": 475132666845504
}

注销勾选结果查询

查询注销勾选/撤销注销勾选申请结果

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/cancel/select/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
reqId String 是 申请注销勾选/撤销注销勾选接口返回的id
customReqId String 否 用户标识ID，需保证唯一性

请求示例

JSON 
{
    "nsrsbh": "91***************3N",
    "reqId": 477604473489600
}

响应参数

参数名 类型 说明
code String 错误码，2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.nsrsbh String 纳税人识别号
data.skssq String 税款所属期，格式：yyyyMM
data.cljg String 处理结果：1=成功，2=无此税号，3=已申请(注销/撤销注销勾选)，4=已注销/撤销注销勾选，99=其他异常
data.zt Integer 任务状态：1=进行中，2=失败，3=成功
data.zxgxlx String 注销勾选类型：1=注销勾选，2=撤销注销勾选
data.code String 任务失败错误码
data.message String 任务失败错误信息

响应示例

JSON 
{
    "reqId": "1accd95fefc343319163afcc2bb5879c",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "nsrsbh": "91****************3N",
        "skssq": "202307",
        "cljg": "1",
        "zt": 1,
        "zxgxlx": "1"
    }
}

统计确认

申请统计

申请统计确认。勾选完成后提交统计申请，统计当前所属期的全部勾选数据。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/apply

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth010",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933253"
    }
}

统计确认

确认统计结果。统计申请成功后需要确认，确认后当期勾选数据不可再修改。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/confirm

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth011",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933254"
    }
}

撤销统计确认

撤销统计确认。在申报前可撤销已确认的统计，撤销后可重新勾选。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/revoke

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.taskId String 任务ID

响应示例

JSON 
{
    "reqId": "auth012",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933255"
    }
}

统计确认/撤销结果查询

统计确认/撤销统计结果查询。查询统计确认或撤销操作的执行状态。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933254"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态
data.tjje Number 统计金额
data.tjse Number 统计税额

响应示例

JSON 
{
    "reqId": "auth033",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933254",
        "status": 3,
        "tjje": 500000,
        "tjse": 65000
    }
}

最新统计确认信息查询

获取企业电子发票服务平台最新统计确认结果

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/latest

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号

请求示例

JSON 
{
    "nsrsbh": "91****************90"
}

响应参数

参数名 类型 说明
code String 错误码，2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data.nsrsbh String 纳税人识别号
data.skssq String 税款所属期，格式：yyyyMM
data.jgzt String 统计确认结果状态：0=未统计，1=已统计未确认，2=已确认，3=已撤销未统计，4=已统计未确认（密码错误）
data.ywlx String 申请标识：1=申请统计，2=撤销统计，3=申请确认，7=退税确认
data.cljg String 申请处理结果：1=成功，2=已申请统计，3=已统计完成等
data.zt String 任务状态：1=进行中，2=失败，3=成功
data.code String 任务失败错误码
data.message String 任务失败错误信息
data.tjsj String 统计时间，格式：yyyyMMddHHmmss
data.time String 任务发起时间
data.id String 申请ID
data.jglx String 机构类型：01=总机构，02=分机构，03=机构本身
data.tjxx Array 统计信息列表
data.jxdkhz Array 增值税申报进项抵扣汇总
data.fpxx Array 发票信息列表
data.cyfpxx Array 差异发票信息列表，结构同fpxx
data.ncptjxx Array 农产品加计扣除勾选统计结果
data.ncpfpxx Array 历史已加计扣除农产品发票信息
data.tszt String 退税任务状态：1=进行中，2=失败，3=成功
data.tsqrjgzt String 退税确认结果状态：2=成功，5=无需确认
data.tstjxx Array 出口退税勾选统计结果
data.tsfpxx Array 退税发票信息

响应示例

JSON 
{
    "reqId": "ce20f30221294095a9c495a0bb1731db",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "cljg": null,
        "cyfpxx": [],
        "fpxx": [],
        "id": null,
        "jglx": null,
        "jgzt": "0",
        "nsrsbh": "91**************2G",
        "skssq": "202211",
        "time": null,
        "tjsj": null,
        "tjxx": [],
        "ywlx": null,
        "zt": null
    }
}

最新统计信息采集

发起最新统计确认信息采集任务

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/collect

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
accountId String 否 登录账户唯一标识，多账号时必传
sync Boolean 否 是否同步获取结果，默认false

请求示例

JSON 
{
    "nsrsbh": "52**************XJ"
}

响应参数

参数名 类型 说明
code String 错误码，2000=成功
success Boolean 是否成功
message String 错误信息
reqId String 请求ID
data String|Object 异步模式返回任务ID；同步模式返回统计确认结果对象
data.nsrsbh String 纳税人识别号（同步模式）
data.skssq String 税款所属期（同步模式）
data.jgzt String 统计确认结果状态：0=未统计，1=已统计未确认，2=已确认，3=已撤销未统计，4=已统计未确认（密码错误）
data.tjsj String 统计时间
data.jglx String 机构类型：01=总机构，02=分机构，03=机构本身
data.zt String 任务状态：1=进行中，2=失败，3=成功
data.code String 任务失败错误码（zt=2时返回）
data.message String 任务失败错误信息（zt=2时返回）
data.tjxx Array 统计信息列表
data.jxdkhz Array 增值税申报进项抵扣汇总
data.ncptjxx Array 农产品加计扣除勾选统计结果
data.fpxx Array 发票信息列表
data.cyfpxx Array 差异发票信息列表，结构同fpxx
data.tszt String 退税任务状态
data.tsqrjgzt String 退税确认结果状态
data.tstjxx Array 出口退税勾选统计结果
data.tsfpxx Array 退税发票信息
data.action String 同步超时转异步时返回操作类型：sqTjqrxxCj
data.taskId String 同步超时转异步时返回的任务ID

响应示例

JSON 
{
    "reqId": "1accd95fefc343319163afcc2bb5879c",
    "code": "2000",
    "success": true,
    "message": null,
    "data": 475132666845504
}

最新统计信息采集结果

最新统计信息采集结果查询。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/stats/collect/result

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.taskId String 是 任务ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "831928300933265"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "reqId": "auth038",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "831928300933265",
        "status": 3
    }
}

进项数据取数

进项发票取数

进项发票取数申请。采集成功后，分页获取可勾选的进项发票列表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/income/fetch

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pageIndex Integer 否 页码，默认1
data.pageSize Integer 否 每页条数，默认20

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.total Integer 总记录数
data.list Array 发票列表
data.list[].fphm String 发票号码
data.list[].je Number 金额
data.list[].se Number 税额
data.list[].gxzt String 勾选状态：0=未勾选/1=已勾选

响应示例

JSON 
{
    "reqId": "auth014",
    "code": "2000",
    "success": true,
    "data": {
        "total": 86,
        "list": [
            {
                "fphm": "23312000000043000001",
                "je": 10000,
                "se": 1300,
                "gxzt": "0"
            }
        ]
    }
}

海关缴款书取数

海关缴款书取数。采集成功后分页获取可勾选的海关缴款书列表。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/customs/fetch

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pageIndex Integer 否 页码
data.pageSize Integer 否 每页条数

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.total Integer 总记录数
data.list Array 缴款书列表

响应示例

JSON 
{
    "reqId": "auth015",
    "code": "2000",
    "success": true,
    "data": {
        "total": 5,
        "list": [
            {
                "jksbh": "202603XXXXXXXX",
                "se": 8500,
                "gxzt": "0"
            }
        ]
    }
}

异步任务回调

异步任务结果回调(认证)

发票认证异步任务结果回调。认证相关任务完成时系统推送到配置的回调地址。

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/auth/async/callback

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID
status Integer 是 0=初始化/1=执行中/2=失败/3=成功
statusMsg String 否 状态描述

请求示例

JSON 
{
    "taskId": "831928300933251",
    "status": 3,
    "statusMsg": "勾选完成"
}

响应参数

参数名 类型 说明
code String 返回2000表示已接收
msg String 处理结果

响应示例

JSON 
{
    "code": "2000",
    "msg": "成功"
}

© 2026 星云税融API. All rights reserved.

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