接口文档 - 星云税融API

接口文档

文档 / 发票归集 / 进项税额转出

发票归集 - 进项税额转出

进销项归集、已勾选归集、同步归集

进项税额转出

发起进项税额转出查询

发起进项税额转出查询。异步任务，获取企业进项税额转出记录。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/tax-transfer/start

请求参数

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

请求示例

JSON

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

响应参数

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

响应示例

JSON

{
    "reqId": "hij456",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933251"
    }
}

查询进项税额转出结果

查询进项税额转出任务结果。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/tax-transfer/result

请求参数

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

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.status	Integer	0=初始化/1=执行中/2=失败/3=成功
data.list	Array	税额转出记录列表

响应示例

JSON

{
    "reqId": "klm789",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933251",
        "status": 3,
        "list": []
    }
}

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