星云税融API

API 文档
Base URL: https://shuiwu.xingyunv2.cn
接口文档
文档 / 社保申报

社保申报

社保数据申报

社保企业登记和查询

社保企业登记和查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/register

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.result Boolean 注册/查询结果

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "result": true
    }
}

社保账户密码上传校验

社保账户密码上传校验

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/pwd/check

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.username String 是 账户名
data.password String 是 密码

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "username": "admin",
        "password": "xxx"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.valid Boolean 校验结果

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "valid": true
    }
}

年度缴费工资查询

年度缴费工资查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/annual-wage/query

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 年度缴费工资列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "xm": "张三",
                "zjhm": "320100199001011234",
                "ndJfgz": 15000
            }
        ]
    }
}

年度缴费工资调整/申报

年度缴费工资调整/申报

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/annual-wage/adjust

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.adjustList Array 是 调整人员列表

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "adjustList": [
            {
                "zjhm": "320100199001011234",
                "newWage": 16000
            }
        ]
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301001"
    }
}

年度缴费工资调整反馈

年度缴费工资调整反馈查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/annual-wage/feedback

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "status": 3
    }
}

月度缴费工资查询

月度缴费工资查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/monthly-wage/query

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.month Integer 是 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "month": 3
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 月度缴费工资列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "xm": "张三",
                "zjhm": "320100199001011234",
                "ydJfgz": 15000
            }
        ]
    }
}

月度缴费工资调整

月度缴费工资调整

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/monthly-wage/adjust

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.month Integer 是 月份
data.adjustList Array 是 调整列表

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "month": 3,
        "adjustList": [
            {
                "zjhm": "320100199001011234",
                "newWage": 16000
            }
        ]
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301002"
    }
}

月度缴费工资调整反馈

月度缴费工资调整反馈查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/monthly-wage/feedback

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "status": 3
    }
}

缴费工资申报记录查询

缴费工资申报记录查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/wage/record

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 申报记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

日常待申报信息查询

日常待申报信息查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/daily/pending

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.month Integer 是 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "month": 3
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 待申报信息

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": [
            {
                "xm": "张三",
                "ylbx": 1200,
                "yilbx": 450
            }
        ]
    }
}

日常申报提交

日常申报提交

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/daily/submit

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.month Integer 是 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "month": 3
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301003"
    }
}

日常申报提交反馈

日常申报提交反馈

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/daily/feedback

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "status": 3
    }
}

特殊缴款待申报信息查询

特殊缴款待申报信息查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/special/pending

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 待申报信息

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

特殊缴款申报提交

特殊缴款申报提交

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/special/submit

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.jkList Array 是 特殊缴款明细

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "jkList": []
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301004"
    }
}

特殊缴款申报提交反馈

特殊缴款申报提交反馈

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/special/feedback

请求参数

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

请求示例

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

响应参数

参数名 类型 说明
code String 2000=成功
data.status Integer 任务状态

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "status": 3
    }
}

社保申报记录查询

社保申报记录查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/declare/record

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 否 年度
data.month Integer 否 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

社保申报作废

社保申报作废

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/declare/void

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.sbId String 是 申报记录ID

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "sbId": "SB20260301001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.result Boolean 作废结果

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "result": true
    }
}

三方协议查询

社保三方协议查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/triparty/query

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 三方协议列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

获取欠费信息

获取社保欠费信息

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/arrears/query

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 三方协议列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

三方协议缴款

社保三方协议缴款

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/triparty/pay

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.month Integer 是 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "month": 3
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301005"
    }
}

银行端缴款凭证打印

银行端缴款凭证打印

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/bank/receipt

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度
data.month Integer 是 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026,
        "month": 3
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301006"
    }
}

银行端缴款凭证作废

银行端缴款凭证作废

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/bank/receipt/void

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.pzbh String 是 凭证编号

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "pzbh": "PZ20260301001"
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.result Boolean 作废结果

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "result": true
    }
}

缴费记录查询

社保缴费记录查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/pay/record

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 否 年度
data.month Integer 否 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

税收完税证明打印

社保税收完税证明打印

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/tax/cert

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301007"
    }
}

单位缴费记录打印

单位缴费记录打印

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/unit/record

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301007"
    }
}

职工缴费记录打印

职工缴费记录打印

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/employee/record

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

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

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "taskId": "SOC20260301007"
    }
}

社保费申报记录人员明细

社保费申报记录人员明细查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/declare/person

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 否 年度
data.month Integer 否 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

单位参保信息查询

单位参保信息查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/unit/info

请求参数

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

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440"
}

响应参数

参数名 类型 说明
code String 2000=成功
data Object 参保信息

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "dwmc": "公司名称",
        "cbrs": 50
    }
}

社保费申报明细查询

社保费申报明细查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/declare/detail

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 否 年度
data.month Integer 否 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

社保费应缴信息查询

社保费应缴信息查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/due/query

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 否 年度
data.month Integer 否 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

职工参保信息查询

职工参保信息查询

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/employee/info

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 否 年度
data.month Integer 否 月份

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 记录列表

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

社保费回调接口

社保费回调接口

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/callback

请求参数

参数名 类型 必填 说明
taskId String 是 任务ID
status Integer 是 任务状态

请求示例

JSON 
{
    "taskId": "SOC20260301003",
    "status": 3
}

响应参数

参数名 类型 说明
code String 返回2000表示已接收

响应示例

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

社保漏报检查

社保漏报检查

登录查看报价
POST https://shuiwu.xingyunv2.cn/api/v1/proxy/social/leak/check

请求参数

参数名 类型 必填 说明
nsrsbh String 是 纳税人识别号
aggOrgId String 是 企业ID
data.year Integer 是 年度

请求示例

JSON 
{
    "nsrsbh": "91320100MA1K2XXXXX",
    "aggOrgId": "452681066557440",
    "data": {
        "year": 2026
    }
}

响应参数

参数名 类型 说明
code String 2000=成功
data.list Array 漏报信息

响应示例

JSON 
{
    "code": "2000",
    "success": true,
    "data": {
        "list": []
    }
}

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

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