接口文档 - 星云税融API

发起进销项归集任务

发起进销项发票归集任务。支持三种模式：进项归集(jx)、销项归集(xx)、进销项同时归集(jxxx)。异步接口，返回taskId后通过查询结果接口获取。

登录查看报价

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

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
accountId	String	否	账号ID
data.gjlx	String	是	归集类型：jx=进项, xx=销项, jxxx=进销项
data.kssj	String	是	开始时间，yyyy-MM-dd
data.jssj	String	是	结束时间，yyyy-MM-dd
data.fpzl	String	否	发票种类，不传默认全部

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "gjlx": "jxxx",
        "kssj": "2026-01-01",
        "jssj": "2026-03-31"
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.taskId	String	任务ID，用于查询结果
data.status	Integer	任务状态：0=初始化/1=执行中/2=失败/3=成功

响应示例

JSON

{
    "reqId": "abc123",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933248",
        "status": 1
    }
}

查询归集任务结果

查询归集任务执行结果。通过发起归集返回的taskId查询任务是否完成。status=3时表示成功，可通过获取发票数据接口取数。

登录查看报价

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

请求参数

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

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.taskId	String	任务ID
data.status	Integer	0=初始化/1=执行中/2=失败/3=成功
data.statusMsg	String	状态描述
data.jxCount	Integer	进项发票数量
data.xxCount	Integer	销项发票数量

响应示例

JSON

{
    "reqId": "def456",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933248",
        "status": 3,
        "statusMsg": "执行完成",
        "jxCount": 128,
        "xxCount": 56
    }
}

获取发票数据

获取已归集的发票数据。归集任务成功后调用，分页获取进项或销项发票明细数据，含票面全部字段。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/data

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
accountId	String	否	账号ID
data.taskId	String	是	归集任务ID
data.fplx	String	否	发票类型：jx=进项, xx=销项
data.pageIndex	Integer	否	页码，默认1
data.pageSize	Integer	否	每页条数，默认20，最大100

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "531928300933248",
        "fplx": "jx",
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	总记录数
data.pageIndex	Integer	当前页码
data.list	Array	发票列表
data.list[].fphm	String	发票号码
data.list[].fpdm	String	发票代码
data.list[].kprq	String	开票日期
data.list[].xfmc	String	销方名称
data.list[].gfmc	String	购方名称
data.list[].jshj	Number	价税合计
data.list[].je	Number	金额
data.list[].se	Number	税额
data.list[].fplx	String	发票类型代码

响应示例

JSON

{
    "reqId": "ghi789",
    "code": "2000",
    "success": true,
    "data": {
        "total": 128,
        "pageIndex": 1,
        "list": [
            {
                "fphm": "23312000000043000001",
                "kprq": "2026-01-15",
                "xfmc": "供应商A有限公司",
                "gfmc": "本企业",
                "jshj": 11300,
                "je": 10000,
                "se": 1300,
                "fplx": "0920"
            }
        ]
    }
}

发起作废/红冲归集

发起作废/红冲发票归集。归集已作废或已红冲的发票数据，用于对账和票据状态同步。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/void

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
accountId	String	否	账号ID
data.gjlx	String	是	归集类型：jx=进项, xx=销项
data.kssj	String	是	开始时间，yyyy-MM-dd
data.jssj	String	是	结束时间，yyyy-MM-dd

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "gjlx": "jx",
        "kssj": "2026-01-01",
        "jssj": "2026-03-31"
    }
}

响应参数

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

响应示例

JSON

{
    "reqId": "jkl012",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933249"
    }
}

发起已勾选归集任务

发起已勾选发票归集。获取已在税局勾选认证的发票数据，常用于进项管理和抵扣统计。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/checked/start

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
accountId	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": "mno345",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933250"
    }
}

查询已勾选归集结果

查询已勾选归集任务结果。通过taskId查询任务执行状态。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/checked/result

请求参数

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

请求示例

JSON

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

响应参数

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

响应示例

JSON

{
    "reqId": "pqr678",
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "531928300933250",
        "status": 3,
        "statusMsg": "执行完成"
    }
}

查询已勾选归集数据

获取已勾选归集数据。任务成功后分页获取已勾选发票明细。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/checked/data

请求参数

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

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "taskId": "531928300933250",
        "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[].gxrq	String	勾选日期

响应示例

JSON

{
    "reqId": "stu901",
    "code": "2000",
    "success": true,
    "data": {
        "total": 45,
        "pageIndex": 1,
        "list": [
            {
                "fphm": "23312000000043000002",
                "je": 8000,
                "se": 1040,
                "gxrq": "2026-03-15"
            }
        ]
    }
}

撤销归集待执行任务

撤销归集待执行任务。仅可撤销状态为"初始化"或"执行中"的任务。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/cancel

请求参数

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

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.result	Boolean	撤销是否成功

响应示例

JSON

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

异步任务执行结果回调(归集)

发票归集异步任务执行结果回调。配置回调地址后，任务完成时系统自动推送结果到您的接口。需联系技术支持配置回调URL。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/async/callback

请求参数

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

请求示例

JSON

{
    "taskId": "531928300933248",
    "status": 3,
    "statusMsg": "执行完成"
}

响应参数

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

响应示例

JSON

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

同步归集-进销项发票

同步模式获取进销项发票。直接返回结果，无需异步轮询，适合少量数据场景。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/sync/info

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
accountId	String	否	账号ID
data.gjlx	String	是	归集类型：jx/xx/jxxx
data.kssj	String	是	开始时间
data.jssj	String	是	结束时间
data.pageIndex	Integer	否	页码
data.pageSize	Integer	否	每页条数

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "gjlx": "jx",
        "kssj": "2026-03-01",
        "jssj": "2026-03-31",
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	总记录数
data.list	Array	发票列表(含全票面信息)

响应示例

JSON

{
    "reqId": "vwx234",
    "code": "2000",
    "success": true,
    "data": {
        "total": 12,
        "list": [
            {
                "fphm": "23312000000043000003",
                "kprq": "2026-03-10",
                "xfmc": "供应商B",
                "jshj": 5650
            }
        ]
    }
}

同步归集-发票基础信息

同步获取发票基础信息。返回发票核心字段（票号/日期/金额/税额），不含明细行，适合快速汇总。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/sync/basic

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.gjlx	String	是	归集类型：jx/xx
data.kssj	String	是	开始时间
data.jssj	String	是	结束时间
data.pageIndex	Integer	否	页码
data.pageSize	Integer	否	每页条数

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "gjlx": "jx",
        "kssj": "2026-03-01",
        "jssj": "2026-03-31"
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	总记录数
data.list	Array	发票基础信息列表

响应示例

JSON

{
    "reqId": "yza567",
    "code": "2000",
    "success": true,
    "data": {
        "total": 12,
        "list": [
            {
                "fphm": "23312000000043000003",
                "kprq": "2026-03-10",
                "je": 5000,
                "se": 650,
                "jshj": 5650
            }
        ]
    }
}

同步归集-发票详情

同步获取发票详情。返回指定发票的完整票面信息，含明细行商品信息。

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/invoice/collect/sync/detail

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
aggOrgId	String	是	企业ID
data.fphm	String	是	发票号码
data.fpdm	String	否	发票代码(税控票必填)
data.kprq	String	否	开票日期

请求示例

JSON

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

响应参数

参数名	类型	说明
code	String	2000=成功
data.fphm	String	发票号码
data.xfmc	String	销方名称
data.gfmc	String	购方名称
data.jshj	Number	价税合计
data.hwxx	Array	货物明细行

响应示例

JSON

{
    "reqId": "bcd890",
    "code": "2000",
    "success": true,
    "data": {
        "fphm": "23312000000043000003",
        "fplx": "0920",
        "kprq": "2026-03-10",
        "xfmc": "供应商B",
        "gfmc": "本企业",
        "je": 5000,
        "se": 650,
        "jshj": 5650,
        "hwxx": [
            {
                "spmc": "办公用品",
                "je": 5000,
                "se": 650,
                "sl": "0.13"
            }
        ]
    }
}

同步归集-应税凭证进项税额转出

同步归集-应税凭证进项税额转出。同步模式直接返回结果。

登录查看报价

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

请求参数

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

请求示例

JSON

{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "skssq": "2026-03",
        "pageIndex": 1,
        "pageSize": 20
    }
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	总记录数
data.list	Array	税额转出记录列表

响应示例

JSON

{
    "reqId": "nop012",
    "code": "2000",
    "success": true,
    "data": {
        "total": 0,
        "list": []
    }
}

发起进项税额转出查询

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

登录查看报价

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": []
    }
}

发票归集

异步归集

发起进销项归集任务

请求参数

请求示例

响应参数

响应示例

查询归集任务结果

请求参数

请求示例

响应参数

响应示例

获取发票数据

请求参数

请求示例

响应参数

响应示例

发起作废/红冲归集

请求参数

请求示例

响应参数

响应示例

发起已勾选归集任务

请求参数

请求示例

响应参数

响应示例

查询已勾选归集结果

请求参数

请求示例

响应参数

响应示例

查询已勾选归集数据

请求参数

请求示例

响应参数

响应示例

撤销归集待执行任务

请求参数

请求示例

响应参数

响应示例

异步任务执行结果回调(归集)

请求参数

请求示例

响应参数

响应示例

同步归集

同步归集-进销项发票

请求参数

请求示例

响应参数

响应示例

同步归集-发票基础信息

请求参数

请求示例

响应参数

响应示例

同步归集-发票详情

请求参数

请求示例

响应参数

响应示例

同步归集-应税凭证进项税额转出

请求参数

请求示例

响应参数

响应示例

进项税额转出

发起进项税额转出查询

请求参数

请求示例

响应参数

响应示例

查询进项税额转出结果

请求参数

请求示例

响应参数

响应示例