接口文档 - 星云税融API

账号创建

创建税局登录账号。gryhm=办税员手机号(非企业税号!)，gryhmm=RSA公钥加密后的税局登录密码，sflx=身份类型(BSY办税员/CWFZR财务负责人/FR法人)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/account/create

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID（订购产品时返回）
dq	String	是	地区编码，见地区码附录
dlfs	Integer	是	登录方式：14=企业登录、15=代理登录
gryhm	String	是	办税员手机号或用户名（非企业税号！在税务局注册的个人登录名）
gryhmm	String	是	税局登录密码，必须RSA公钥加密后传输（Base64编码）
encryptionType	Integer	是	加密类型，固定传1
sflx	String	是	身份类型：BSY=办税员、CWFZR=财务负责人、FR=法人
sjhm	String	是	办税员手机号（接收短信验证码的手机号）

请求示例

JSON

{
    "aggOrgId": 12345,
    "dq": "11",
    "dlfs": 14,
    "gryhm": "13800000000",
    "gryhmm": "RSA加密后的密码(Base64)",
    "encryptionType": 1,
    "sflx": "BSY",
    "sjhm": "13800000000"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.accountId	Integer	账号唯一标识，需保存用于后续接口

响应示例

JSON

{
    "reqId": "1f4bf3651c734b94b08daaed42408ef0",
    "code": "2000",
    "success": true,
    "message": "",
    "data": {
        "accountId": 504325035988992,
        "aggOrgId": 7583454730897015,
        "gryhm": "13466759052",
        "sflx": "KPY",
        "dq": "11",
        "dlfs": 9,
        "state": 1,
        "createTime": "2023-12-19 14:24:24"
    }
}

账号修改

修改托管税局登录账号。accountId必填!gryhm=办税员手机号，gryhmm=RSA公钥加密后的密码

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/account/update

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID
accountId	String	是	账号ID（创建账号时返回）
gryhm	String	否	办税员手机号（非企业税号！）
gryhmm	String	否	RSA加密后的税局登录密码
encryptionType	Integer	否	加密类型，使用RSA加密时固定传1
sflx	String	否	身份类型：BSY/CWFZR/FR
sjhm	String	否	办税员手机号

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "accountId": 504325035988992,
    "dq": "11",
    "dlfs": 14,
    "sflx": "BSY",
    "gryhm": "13800000000",
    "gryhmm": "RSA加密后的密码(Base64)",
    "encryptionType": 1,
    "sjhm": "13800000000"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Boolean	true=修改成功

响应示例

JSON

{
    "code": "2000",
    "data": true,
    "success": true,
    "message": "",
    "reqId": "f3a2efacd7644977a6506f41f9bd6aa7"
}

账号删除

删除税局登录账号

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/account/delete

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID
accountId	String	是	账号ID

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "accountId": 504325035988992
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Boolean	true=删除成功

响应示例

JSON

{
    "code": "2000",
    "data": true,
    "success": true,
    "message": "",
    "reqId": "fe8f9204890146718cefe5c33ac85a5a"
}

账号查询

查询税局登录账号信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/account/query

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID

请求示例

JSON

{
    "aggOrgId": 452681066557440
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	账号列表，含accountId、gryhm、sflx、dq、dlfs、state

响应示例

JSON

{
    "code": "2000",
    "data": [
        {
            "newEtaxFlag": -1,
            "sflx": "KPY",
            "dq": "1100",
            "accountId": 501319884953664,
            "zhzt": "",
            "gryhm": "13466759059",
            "nsrsbh": "91xxxxxxxxxxxx",
            "productCode": "004",
            "createTime": "2023-12-02 14:48:26",
            "isDefaut": false,
            "appKey": 10001999,
            "dlfs": 14,
            "aggOrgId": 452681066557440,
            "state": 1
        }
    ],
    "success": true,
    "message": "",
    "reqId": "cb156062d05944d4bb10b2be18233028"
}

发送短信验证码

触发税局下发短信验证码（支持企业登录dlfs=14和代理登录dlfs=15）

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/sms/send

请求参数

参数名	类型	必填	说明
aggOrgId	String/Integer	是	企业ID
accountId	String	否	账号ID（多账号时必填）

请求示例

JSON

{
    "aggOrgId": 522704190568512,
    "accountId": "522756466521335"
}

响应参数

参数名	类型	说明
code	String	2000=成功；4xxx=登录信息有误；8xxx=短信发送频繁
data.taskId	String	异步任务ID，上传验证码时使用

响应示例

JSON

{
    "code": "2000",
    "data": {
        "taskId": 1780851217847750700
    },
    "success": true,
    "reqId": "60ffd6de076a46bea9de8acc66cab677"
}

上传短信验证码

上传收到的短信验证码完成登录

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/sms/upload

请求参数

参数名	类型	必填	说明
taskId	String	是	发送短信验证码返回的taskId
smsCode	String	是	用户收到的短信验证码（6位数字）

请求示例

JSON

{
    "taskId": "1780486852186337281",
    "smsCode": "787452"
}

响应参数

参数名	类型	说明
code	String	2000=登录成功；4xxx=登录信息有误
message	String	登录结果描述

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "message": "登录成功",
    "reqId": "309eaeb955ba48cfa85fa083553e5d40"
}

校验税局缓存有效性

检查税局登录缓存是否仍然有效

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/cache/check

请求参数

参数名	类型	必填	说明
aggOrgId	String/Integer	是	企业ID
accountId	String	否	账号ID

请求示例

JSON

{
    "aggOrgId": "567666674637436",
    "accountId": "56766632222436"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Boolean	true=缓存有效，false=缓存失效

响应示例

JSON

{
    "code": "2000",
    "data": false,
    "success": true,
    "message": "",
    "reqId": "d8e97e6e88514e329f28386d2d07f6f0"
}

校验能否快速登录

校验税局是否能快速登录(免验证码)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/fast/check

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID
accountId	String	否	账号ID

请求示例

JSON

{
    "aggOrgId": 522704190568512,
    "accountId": "522756466521335"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Boolean	true=可以快速登录，false=不可以

响应示例

JSON

{
    "code": "2000",
    "data": true,
    "success": true,
    "message": "可以快速登录",
    "reqId": "b026400e32f54ed7a5846f42b3c4ddd0"
}

登出

登出税局会话

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/logout

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID
accountId	String	是	账号ID
type	String	否	清理类型：0=缓存,1=指纹，多个逗号分隔，默认0,1

请求示例

JSON

{
    "aggOrgId": 452681066557440,
    "accountId": 504325035988992,
    "type": "0,1"
}

响应参数

参数名	类型	说明
code	String	2000=成功

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "message": "删除指纹成功",
    "reqId": "1a254acbe29d4c248e41c41607d42efb",
    "data": null
}

账密检查

检查账号密码是否正确

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/pwd/check

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
accountId	String	是	账号ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "accountId": "504325035988992"
}

响应参数

参数名	类型	说明
code	String	2000=成功
success	Boolean	账密是否正确

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "message": "账号密码正确",
    "reqId": "1515cc8e7f714813a774581839956a5f"
}

获取代理登录企业列表

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/agent/list

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID

请求示例

JSON

{
    "aggOrgId": "452681066557440"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.total	Integer	企业总数
data.details	Array	企业列表，含nsrsbh、name

响应示例

JSON

{
    "code": "2000",
    "data": {
        "total": 15,
        "details": [
            {
                "nsrsbh": "91xxxxxxxxxxxx",
                "name": "XXX有限公司",
                "sflx": "BSY"
            }
        ]
    },
    "success": true,
    "message": "查询成功",
    "reqId": "dc5ead3635244a0498c878906cb499b7"
}

查询登录切换次数

查询用户登录切换次数(托管)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/switch/count

请求参数

参数名	类型	必填	说明
aggOrgId	String	是	企业ID
accountId	String	是	账号ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "accountId": "504325035988992"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.currentSwitchCount	Integer	当前切换次数
data.todaySwitchCount	Integer	今日切换次数

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "message": "成功",
    "data": {
        "currentSwitchCount": 1,
        "currentSwitchCheckStartTime": "2024-03-04 09:47:47",
        "todaySwitchCount": 1
    },
    "reqId": "T65f49f8bf25b422d99e92c237463d9ec"
}

托管获取企业列表

托管模式获取企业列表

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/login/hosted/list

请求参数

参数名	类型	必填	说明
aggOrgId	Integer	是	企业ID
accountId	String	是	账号ID

请求示例

JSON

{
    "aggOrgId": "452681066557440",
    "accountId": "504325035988992"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data	Array	企业列表，含nsrsbh、nsrmc、sflx、glzt

响应示例

JSON

{
    "code": "2000",
    "data": [
        {
            "xh": 0,
            "nsrsbh": "91xxxxxxxxxxxx",
            "nsrmc": "XXX有限公司",
            "sflx": "BSY",
            "glzt": "00"
        }
    ],
    "success": true,
    "message": "成功",
    "reqId": "abab0a8351b04524b79a335ed3eee5dc"
}

登录增强版(新)

账号创建

请求参数

请求示例

响应参数

响应示例

账号修改

请求参数

请求示例

响应参数

响应示例

账号删除

请求参数

请求示例

响应参数

响应示例

账号查询

请求参数

请求示例

响应参数

响应示例

发送短信验证码

请求参数

请求示例

响应参数

响应示例

上传短信验证码

请求参数

请求示例

响应参数

响应示例

校验税局缓存有效性

请求参数

请求示例

响应参数

响应示例

校验能否快速登录

请求参数

请求示例

响应参数

响应示例

登出

请求参数

请求示例

响应参数

响应示例

账密检查

请求参数

请求示例

响应参数

响应示例

获取代理登录企业列表

请求参数

请求示例

响应参数

响应示例

查询登录切换次数

请求参数

请求示例

响应参数

响应示例

托管获取企业列表

请求参数

请求示例

响应参数

响应示例