税务等级接口
企业纳税等级信息
请求方式
- 请求地址:
http://api.shuidi.cn/biz/taxCredit
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/biz/taxCredit?pname=patest&ptime=1571990576623&vkey=2237ae09ea514c43a37ab0c57968f536&key=交通银行股份有限公司
接口认证
客户每次调用接口,必需包含接入ID(pname), 安全验证码(vkey)和时间戳(ptime).
参数名称 | 类型 | 是否必填 | 说明 | 示例值 |
---|---|---|---|---|
pname | String | 是 | 调用方唯一ID,用于身份识别 | patest |
ptime | String | 是 | 时间戳,从格林威治时间1970年01月01日00时00分00秒起至现在的时间,精确到毫秒(13位) | 1571990576623 |
vkey | String | 是 | 安全验证码。使用下划线依次连接pkey、ptime、pkey,计算该字符串的MD5值完成签名. 结果为32个字符 |
2237ae09ea514c43a37ab0c57968f536 |
Java计算vkey示例:
String ptime =String.valueOf(System.currentTimeMillis());
SecureUtil.md5(pkey + "_" + ptime + "_" + pkey);
php计算vkey示例:
$vkey=md5($pkey.”_”.$ptime.”_”.$pkey)
请求参数
参数名称 | 类型 | 是否必填 | 说明 | 示例 |
---|---|---|---|---|
key | String | 是 | 搜索关键字(公司名、注册号或社会统一信用代码) | 交通银行股份有限公司 |
响应结果
返回数据格式
所有接口返回值以JSON字符串的形式返回给调用者,JSON格式如下:
{ "statusCode": 1, "statusMessage": "请求成功", "data": {} }
返回JSON属性如下:
属性 | 说明 |
---|---|
statusCode | 返回查询结果编码 |
statusMessage | statusCode不为1时的错误信息描述。 |
data | 结果数据。不同接口,data的内容会有所不同。具体见各接口返回说明。 |
响应示例
{
"statusCode": 1,
"statusMessage": "请求成功",
"data": [{
"taxPayerNo": "9131000010000595XD",
"taxPayerName": "交通银行股份有限公司",
"year": "2016",
"level": "A",
"evalOffice": "国家税务总局"
},
{
"taxPayerNo": "31004310000595X",
"taxPayerName": "交通银行股份有限公司",
"year": "2014",
"level": "A",
"evalOffice": "市税务三分局"
},
{
"taxPayerNo": "31004310000595X",
"taxPayerName": "交通银行股份有限公司",
"year": "2015",
"level": "A",
"evalOffice": "国家税务总局"
},
{
"taxPayerNo": "9131000010000595XD",
"taxPayerName": "交通银行股份有限公司",
"year": "2017",
"level": "A",
"evalOffice": "国家税务总局"
},
{
"taxPayerNo": "9131000010000595XD",
"taxPayerName": "交通银行股份有限公司",
"year": "2018",
"level": "A",
"evalOffice": "国家税务总局"
},
{
"taxPayerNo": "9131000010000595XD",
"taxPayerName": "交通银行股份有限公司",
"year": "2019",
"level": "A",
"evalOffice": "国家税务总局"
}
]
}
输出结果字段含义
属性名 | 类型 | 含义 |
---|---|---|
taxPayerNo | String | 纳税人识别号 |
taxPayerName | String | 纳税人名称 |
year | String | 评价年度 |
level | String | 信用等级 |
evalOffice | String | 评价单位 |
错误编码
错误编码 | 说明 |
---|---|
1 | 请求成功 |
2 | 未查询到数据 |
3 | 接口未授权 |
4 | 请求参数错误 |
30001 | 请求已过期 |
99999 | 系统错误 |