接口文档 - 星云税融API

发起企业基本信息采集

发起企业基本信息采集任务

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/company/info/start

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
areaCode	String	是	地区编码

请求示例

JSON

{
    "nsrsbh": "91xxxxxxxxxxxx0",
    "areaCode": "11"
}

响应参数

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

响应示例

JSON

{
    "reqId": "19399fbf85694c71bc5448a392ad8dd0",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "taskId": "12345678"
    }
}

发起企业基本信息

发起企业基本信息采集(用nsrsbh+areaCode，区分自持/托管模式)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/company/basic/start

请求参数

参数名	类型	必填	说明
nsrsbh	String	是	纳税人识别号
areaCode	String	是	地区编码(二位或四位)，见附录地区代码

请求示例

JSON

{
    "nsrsbh": "91************0",
    "areaCode": "11"
}

响应参数

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

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "reqId": "19399fbf85694c71bc5448a392ad8dd0",
    "data": {
        "taskId": "12345678"
    }
}

获取企业基本信息

获取已采集的企业基本信息

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/company/info/get

请求参数

参数名	类型	必填	说明
taskId	String	是	采集任务ID
nsrsbh	String	是	纳税人识别号

请求示例

JSON

{
    "taskId": "189767182727906",
    "nsrsbh": "91xxxxxxxxxxxx0"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.status	Integer	任务状态：1=排队中,2=执行中,3=完成,4=失败
data.jcxx	Object	企业基本信息数据（status=3时返回）

响应示例

JSON

{
    "reqId": "679c89b57c3a4d2",
    "code": "2000",
    "success": true,
    "message": null,
    "data": {
        "statusMsg": "完成",
        "jcxx": {
            "taxCompanyEnterpriseInfoDtoPageResult": {
                "nsrsbh": "9131011000000",
                "nsrmc": "XXXX有限公司",
                "nslxmc": "增值税一般纳税人"
            }
        },
        "statusDetails": {
            "mainStatusCode": "2000",
            "jcxx": {
                "groupStatusDetail": {
                    "BASIC_INFO": {
                        "code": "2000",
                        "hasLoginErr": "0",
                        "codeMsg": "执行完成",
                        "status": 3
                    }
                },
                "loginCode": "2000",
                "status": 3
            },
            "main": 3
        },
        "status": 3
    }
}

获取企业基本信息

查询beginOrgInfoTask任务状态及获取企业基本信息数据(status=3时采集完成)

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/company/basic/query

请求参数

参数名	类型	必填	说明
taskId	String	是	发起企业基本信息任务返回的taskId
nsrsbh	String	是	纳税人识别号

请求示例

JSON

{
    "taskId": "189767182727906",
    "nsrsbh": "9********0"
}

响应参数

参数名	类型	说明
code	String	2000=成功
data.status	Integer	-1=任务创建失败,0=无任务,1=进行中,3=完成
data.statusMsg	String	任务状态描述
data.jcxx	Object	企业基本信息(status=3时返回，含nsrsbh/nsrmc/nslxmc等)
data.statusDetails	Object	任务状态详情

响应示例

JSON

{
    "code": "2000",
    "success": true,
    "data": {
        "status": 3,
        "statusMsg": "完成",
        "jcxx": {
            "taxCompanyEnterpriseInfoDtoPageResult": {
                "nsrsbh": "91xxx",
                "nsrmc": "XXX有限公司",
                "nslxmc": "增值税一般纳税人"
            }
        }
    }
}

企业取消授权

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/company/unauth

请求参数

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

请求示例

JSON

{
    "aggOrgId": 452681066557440
}

响应参数

参数名	类型	说明
code	String	SUCCESS=成功
data	Boolean	true=取消成功

响应示例

JSON

{
    "reqId": "9195e4569635498295e076b78d164acb",
    "code": "SUCCESS",
    "success": true,
    "message": "",
    "data": true
}

回调通知-获取采集状态

回调通知-获取企业基本信息采集状态

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/company/info/callback

请求参数

参数名	类型	必填	说明
taskId	String	是	任务ID
status	Integer	是	任务完成状态：-1=创建失败，0=无任务，1=进行中，3=完成
statusMsg	String	否	任务完成状态描述
statusDetails	Object	是	任务状态详情
statusDetails.main	String	是	分组总状态：1=进行中，2=失败（任一失败），3=成功
statusDetails.mainStatusCode	String	是	分组总code：8000=存在登录失效任务，2000=全部成功，5000=部分失败
statusDetails.jcxx	Object	否	分组任务状态详情节点

请求示例

JSON

{
    "taskId": "544290009248",
    "status": 3,
    "statusMsg": "执行完成",
    "statusDetails": {
        "main": 3,
        "mainStatusCode": "2000",
        "jcxx": {
            "groupStatusDetail": {
                "BASIC_INFO": {
                    "code": "2000",
                    "hasLoginErr": "0",
                    "codeMsg": "任务处理成功: 执行完成",
                    "status": 3
                }
            },
            "loginCode": "2000",
            "status": 3
        }
    }
}

响应参数

参数名	类型	说明
code	String	接收响应Code
msg	String	接收响应消息

响应示例

JSON

{
    "code": "2000",
    "msg": "已接收"
}

配置公共回调地址

登录查看报价

POST https://shuiwu.xingyunv2.cn/api/v1/proxy/common/callback/config

请求参数

参数名	类型	必填	说明
(回调报文) msg	String	否	回调消息
(回调报文) taskStatus	Integer	否	任务状态
(回调报文) taskId	String	否	任务ID

请求示例

JSON

{
    "msg": "success",
    "taskStatus": 3,
    "taskId": "5151471684213235391"
}

响应参数

参数名	类型	说明
code	String	返回字符串2000表示成功
msg	String	返回消息说明

响应示例

JSON

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