星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 发票归集 / 同步归集

发票归集 - 同步归集

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

同步归集

同步归集-进销项发票

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

登录查看报价
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": []
    }
}

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

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