API文档 经营风险 欠税信息
基本信息
接口地址
https://api.qixin.com/APIService/overduetax/getOverDueTaxByName
数据格式
JSON
请求方式
GET
请求示例
http://api.qixin.com/APIService/overduetax/getOverDueTaxByName?name=拉德餐饮(上海)有限公司
描述
企业欠税信息,包括纳税人类型、纳税人识别号、欠税税种、余额等
请求参数 (Headers)
参数名类型必填描述
Auth-Version String 2.0(参数值),固定传入:2.0
appkey String 启信慧眼数据开放平台获取 ,获取方式:个人中心-安全中心-API 密钥,获取appkey的同时,请完成IP白名单的配置:个人中心-安全中心-API IP白名单设置,如未配置,接口调试会报错“104 未添加IP白名单”
timestamp String UNIX时间戳,精确到毫秒,示例:1656921036000,当前系统时间近10分钟有效
sign String 请求认证签名,对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果,小写字符串(实际加密不带入‘+’)
请求参数 (Query)
参数名类型必填描述
name String 企业全名/注册号/统一社会信用代码
skip Number 跳过条目数(跳过的条数,默认不填返回前10条,取11到20条的数据,skip=10,以此类推进行取数)
响应参数
参数名类型长度描述
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回为空。具体字段含义见下表
total
data.data.total
Number 0 返回列表中记录总数
num
data.data.num
Number 0 本次调用返回记录数
items
data.data.items
Array 0 欠税信息列表
overdue_period
data.data.items.overdue_period
String 1000 欠税所属期
is_history
data.data.items.is_history
String 3 是否历史信息(0:否,1:是)
pub_department
data.data.items.pub_department
String 1000 发布单位
taxpayer_type
data.data.items.taxpayer_type
String 255 纳税人类型
pub_date
data.data.items.pub_date
String 50 发布日期
area
data.data.items.area
String 1000 所属市县区
address
data.data.items.address
String 500 经营地点
oper_name
data.data.items.oper_name
String 255 负责人姓名
taxpayer_num
data.data.items.taxpayer_num
String 255 纳税人识别号
overdue_amount
data.data.items.overdue_amount
Number 255 欠税余额
overdue_time
data.data.items.overdue_time
String 50 发生欠税的时间
overdue_type
data.data.items.overdue_type
String 255 欠税税种
oper_id_num
data.data.items.oper_id_num
String 255 企业证照号
curr_overdue_amount
data.data.items.curr_overdue_amount
Number 255 当前发生的欠税余额,单位:元
overdue_penalty
data.data.items.overdue_penalty
Number 255 已缴纳欠税对应形成的欠缴税款滞纳金金额
sign
data.sign
String 32 数据签名
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "b0190873764942c082f5d4cfad9ed11a",
    "data": {
        "total": 2,
        "num": 2,
        "items": [
            {
                "taxpayer_type": "-",
                "taxpayer_num": "310101590438001",
                "oper_name": "STEPHEN BAKER",
                "oper_id_num": "-",
                "address": "-",
                "overdue_type": "营业税",
                "overdue_amount": 5746.2,
                "curr_overdue_amount": 0,
                "area": "-",
                "overdue_period": "-",
                "pub_date": "-",
                "pub_department": "黄浦区税务局",
                "is_history": "1",
                "overdue_time": "-",
                "overdue_penalty": null
            },
            {
                "taxpayer_type": "-",
                "taxpayer_num": "310101590438001",
                "oper_name": "STEPHEN BAKER",
                "oper_id_num": "-",
                "address": "-",
                "overdue_type": "城建税",
                "overdue_amount": 402.23,
                "curr_overdue_amount": 0,
                "area": "-",
                "overdue_period": "-",
                "pub_date": "-",
                "pub_department": "黄浦区税务局",
                "is_history": "1",
                "overdue_time": "-",
                "overdue_penalty": null
            }
        ]
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/overduetax/getOverDueTaxByName';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');

let urlParams = {
    name: 'name的值',
    skip: 'skip的值'
}

let concatParams = []
for (let key in urlParams) {
    concatParams.push(key + '=' + urlParams[key]);
}

let options = {
    'method': 'GET',
    'url': baseUrl + '?' + concatParams.join('&'),
    'headers': {
        'Connection': 'keep-alive',
        'Auth-version': '2.0',
        'appkey': appkey,
        'timestamp': timeStamp,
        'sign': sign
    }
};

request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});