税务等级接口


企业纳税等级信息

请求方式

  • 请求地址: 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 系统错误

results matching ""

    No results matching ""