星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票认证 / 税款所属期

发票认证 - 税款所属期

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

税款所属期

获取税款所属期

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

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

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

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