星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票认证 / 进项数据采集

发票认证 - 进项数据采集

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

进项数据采集

进项发票采集

进项发票采集

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

登录查看报价
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
    }
}

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

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