企业年报信息接口
包含两个接口：
- 查询年报概况接口
- 查询年报详情接口
1. 查询年报概况接口
查询公司年报概要信息
请求方式
- 请求地址:
http://api.shuidi.cn/ic/ar/list
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/ic/ar/list?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": [
{
"reportYear": "2015",
"hasDetailInfo": "true",
"publishDate": "2016-05-30"
},
{
"reportYear": "2017",
"hasDetailInfo": "true",
"publishDate": "2018-06-13 00:00:00"
},
{
"reportYear": "2016",
"hasDetailInfo": "true",
"publishDate": "2017-06-22"
},
{
"reportYear": "2014",
"hasDetailInfo": "true",
"publishDate": "2015-05-19"
},
{
"reportYear": "2013",
"hasDetailInfo": "true",
"publishDate": "2015-05-19"
},
{
"reportYear": "2018",
"hasDetailInfo": "true",
"publishDate": null
},
{
"reportYear": "2019",
"hasDetailInfo": "true",
"publishDate": null
}
]
}
输出结果字段含义
| 属性名 |
类型 |
含义 |
| reportYear |
String |
年报年份 |
| hasDetailInfo |
String |
是否含有详情(True/False) |
| publishDate |
String |
发布日期 |
错误编码
| 错误编码 |
说明 |
| 1 |
请求成功 |
| 2 |
未查询到数据 |
| 3 |
接口未授权 |
| 4 |
请求参数错误 |
| 30001 |
请求已过期 |
| 99999 |
系统错误 |
2. 查询年报详情接口
本接口用于查询企业年报详细数据
请求方式
- 请求地址:
http://api.shuidi.cn/ic/ar/details
- 请求方式:
GET/POST
- 支持格式:
JSON
- 请求示例:
http://api.shuidi.cn/ic/ar/details?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": [
{
"reportYear": "2019",
"hasDetailInfo": "true",
"publishDate": null,
"basicInfoData": {
"regNo": "110108012660422",
"companyName": "小米科技有限责任公司",
"operatorName": null,
"contactNo": "010-69630728",
"postCode": "100085",
"address": "北京市海淀区西二旗中路33号院6号楼6层006号",
"emailAddress": "chenchongwei@xiaomi.com",
"isStockRightTransfer": null,
"status": "开业",
"hasWebSite": null,
"hasNewStockOrByStock": null,
"employeeCount": "企业选择不公示",
"belongTo": null,
"capitalAmount": null,
"hasProvideAssurance": null,
"operationPlaces": null,
"mainType": null,
"operationDuration": "",
"ifContentSame": null,
"differentContent": null,
"generalOperationItem": null,
"approvedOperationItem": null
},
"assetsData": {
"totalAssets": "企业选择不公示",
"totalOwnersEquity": "企业选择不公示",
"grossTradingIncome": "企业选择不公示",
"totalProfit": "企业选择不公示",
"mainBusinessIncome": "企业选择不公示",
"netProfit": "企业选择不公示",
"totalTaxAmount": "企业选择不公示",
"totalLiabilities": "企业选择不公示",
"bankingCredit": null,
"governmentSubsidy": null
},
"changeList": [],
"investInfoList": [
{
"no": null,
"name": "北京创派力量科技有限公司",
"regNo": "911101080696123",
"shouldCapi": null,
"shareHoldingRatio": null
},
{
"no": null,
"name": "北京聚爱聊网络科技有限公司",
"regNo": "911101080994495",
"shouldCapi": null,
"shareHoldingRatio": null
},
{
"no": null,
"name": "英鹏互娱科技（北京）有限公司",
"regNo": "911101080828880",
"shouldCapi": null,
"shareHoldingRatio": null
}
],
"partnerList": [
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963",
"shouldDate": "2015-10-29",
"shouldType": "货币",
"realCapi": "3718.4963",
"realDate": "2015-10-29",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18623.099",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18623.099",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18623.099万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18623.099万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478",
"shouldDate": "2015-10-29",
"shouldType": "货币",
"realCapi": "143934.0478",
"realDate": "2015-10-29",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18623.099",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "刘德",
"shouldCapi": "3718.4963",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "3718.4963",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18623.099",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "洪锋",
"shouldCapi": "18623.099",
"shouldDate": "2015-10-29",
"shouldType": "货币",
"realCapi": "18623.099",
"realDate": "2015-10-29",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "黎万强",
"shouldCapi": "18724.3569",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "18724.3569",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478万元",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478万元",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
},
{
"no": 0,
"name": "雷军",
"shouldCapi": "143934.0478",
"shouldDate": "2015-10-30",
"shouldType": "货币",
"realCapi": "143934.0478",
"realDate": "2015-10-30",
"realType": "货币",
"form": null,
"investmentRatio": null
}
],
"stockChangeList": [],
"webSiteList": [
{
"no": null,
"type": "网店",
"name": "小米商城",
"website": "www.mi.com"
}
],
"administrationLicenseList": null,
"branchList": null,
"employeeList": null,
"provideAssuranceList": []
}
]
}
输出结果字段含义
| 属性名 |
类型 |
含义 |
| reportYear |
String |
年报年份 |
| hasDetailInfo |
String |
是否含有详情(True/False） |
| publishDate |
String |
发布日期 |
basicInfoData(基本信息)
| 属性名 |
类型 |
含义 |
| regNo |
String |
注册号 |
| companyName |
String |
企业名称 |
| operatorName |
String |
经营者姓名 |
| contactNo |
String |
企业联系电话 |
| postCode |
String |
邮政编码 |
| address |
String |
企业通信地址 |
| emailAddress |
String |
电子邮箱 |
| isStockRightTransfer |
String |
有限责任公司本年度是否发生股东股权转让 |
| status |
String |
企业经营状态 |
| hasWebSite |
String |
是否有网站或网店 |
| hasNewStockOrByStock |
String |
是否有投资信息或购买其他公司股权 |
| employeeCount |
String |
从业人数 |
| belongTo |
String |
隶属关系 |
| hasProvideAssurance |
String |
是否有对外提供担保信息 |
| operationPlaces |
String |
企业通信地址 |
assetsData(企业资产状况信息)
| 属性名 |
类型 |
含义 |
| totalAssets |
String |
资产总额 |
| totalOwnersEquity |
String |
所有者权益合计 |
| grossTradingIncome |
String |
营业总收入 |
| totalProfit |
String |
利润总额 |
| mainBusinessIncome |
String |
营业总收入中主营业务收入 |
| netProfit |
String |
净利润 |
| totalTaxAmount |
String |
纳税总额 |
| totalLiabilities |
String |
负债总额 |
| bankingCredit |
String |
金融贷款 |
| governmentSubsidy |
String |
获得政府扶持资金、补助 |
changeList(修改信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| changeName |
String |
修改事项 |
| before |
String |
变更前内容 |
| after |
String |
变更后内容 |
| changeDate |
String |
变更日期 |
investInfoList(对外投资信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| name |
String |
投资设立企业或购买股权企业名称 |
| regNo |
String |
注册号 |
| shouldCapi |
String |
认缴出资额(万元 |
| shareHoldingRatio |
String |
持股比例(% |
partnerList(股东及出资信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| name |
String |
股东/发起人 |
| shouldCapi |
String |
认缴出资额 |
| shouldDate |
String |
认缴出资时间 |
| shouldType |
String |
认缴出资方式 |
| realCapi |
String |
实缴出资额 |
| realDate |
String |
实缴出资时间 |
| realType |
String |
实缴出资方式 |
| form |
String |
出资类型 |
| investmentRatio |
String |
出资比例 |
stockChangeList(股权变更信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| name |
String |
股东 |
| before |
String |
变更前股权比例 |
| after |
String |
变更后股权比例 |
| changeDate |
String |
股权变更日期 |
webSiteList(网站或网店信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| type |
String |
类型 |
| name |
String |
名称 |
| website |
String |
网址 |
administrationLicenseList(行政许可信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| name |
String |
许可文件名称 |
| endDate |
String |
有效期至 |
branchList(分支机构信息)
| 属性名 |
类型 |
含义 |
| name |
String |
分支机构名称 |
| regNo |
String |
注册号 |
| address |
String |
住所 |
| principal |
String |
负责人 |
employeeList(主要人员信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| name |
String |
名称 |
| job |
String |
职位 |
| cerNo |
String |
证照/证件号码 |
| scertName |
String |
证件名称 |
provideAssuranceList(对外提供保证担保信息)
| 属性名 |
类型 |
含义 |
| no |
String |
序号 |
| creditor |
String |
债权人 |
| debtor |
String |
债务人 |
| creditorCategory |
String |
主债权种类 |
| creditorAmount |
String |
主债权数额 |
| fulfillObligation |
String |
履行债务的期限 |
| assuranceDurn |
String |
保证的期间 |
| assuranceType |
String |
保证的方式 |
| assuranceScope |
String |
保证担保的范围 |
错误编码
| 错误编码 |
说明 |
| 1 |
请求成功 |
| 2 |
未查询到数据 |
| 3 |
接口未授权 |
| 4 |
请求参数错误 |
| 30001 |
请求已过期 |
| 99999 |
系统错误 |