点击右侧按钮复制完整请求地址，参数值请替换为实际有效值

请求参数 （暂无请求参数）

请求参数说明

# 接口名称：企业年报查询

#### 描述：年报包含企业自己申报的基本信息，网站或网店信息，发起人及出资信息，企业资产状态和股权变更信息等
请求地址 url：https://api.shuliancloud.com/v4/year_report/query
请求方式 method：get/post
参数（如body传参以表单方式提交，不要json方式）：

|  名称 |  类型 |是否必填   | 说明  |
| ------------ | ------------ | ------------ | ------------ |
| appid  |  varchar |  是 | 服务商分配的唯一标识  |
| timestamp |  number | 是  | 当前时间的毫秒数  |
| sign  | varchar  | 是  | 签名，<a href='#sign'>签名算法说明</a>  |
| keyword  |  varchar | 是  | 关键字，公司名全称、注册号、统一社会信用代码  |



<a name="sign">

#### 签名算法说明：
######  服务商分配的appid、当前时间毫秒数timestamp、服务商分配的app_security、 三者通过&符号拼接成字符串进行md5加密得到。
     如：appid=xyzxyzxyz，timestamp=1555378976238，app_security=efcefcefcefcefc ;
     拼接后的字符串：str=xyzxyzxyz&1555378976238&efcefcefcefcefc ;
     加密后得到sign = md5(str) = 4e7e1974b79f3656aeaf03f1158f5d5d ;
</a>

#### 正确返回：
```
{
    "msg": "成功",
    "success": true,
    "code": 200,
    "data": {
        "orderNo": "109463017524729611",
        "data": {
            "total": 8,
            "items": [
                {
                    "stockChangeList": [],//股权变更信息
                    "investInfoList": [], //对外投资信息
                    "partnerList": [
                        {
                            "shouldDate": "2036-12-20",
                            "realType": "",
                            "shouldType": "货币",
                            "realCapi": "0",
                            "name": "刘贵龙",
                            "shouldCapi": "1000",
                            "realDate": null
                        }
                    ],
                    "year": "2023",
                    "provideAssuranceList": [],
                    "hasDetailInfo": true,
                    "changeList": [],
                    "publishDate": "2024-04-25",
                    "assetsData": [
                        {
                            "bankingCredit": null,
                            "mainBusinessIncome": "企业选择不公示",
                            "governmentSubsidy": null,
                            "totalProfit": "企业选择不公示",
                            "totalAssets": "企业选择不公示",
                            "totalLiabilities": "企业选择不公示",
                            "totalOwnersEquity": "企业选择不公示",
                            "grossTradingIncome": "企业选择不公示",
                            "totalTaxAmount": "企业选择不公示",
                            "netProfit": "企业选择不公示"
                        }
                    ],
                    "webSiteList": [],
                    "socialSecurity": [],
                    "basicInfoData": {
                        "regNo": "330106000568842",
                        "address": "浙江省杭州市余杭区仓前街道浙江省杭州市余杭区仓前街道向往街1008号9幢601室",
                        "hasProvideAssurance": "否",
                        "operationDuration": null,
                        "companyName": "杭州数脉科技有限公司",
                        "mainType": null,
                        "operatorName": "",
                        "employeeCount": "企业选择不公示",
                        "hasWebSite": "否",
                        "emailAddress": "shumai@shumaidata.com",
                        "belongTo": "",
                        "postCode": "900000",
                        "hasNewStockOrByStock": "否",
                        "isStockRightTransfer": "否",
                        "capitalAmount": null,
                        "contactNo": "0571-89020021",
                        "status": "开业",
                        "operationPlaces": "浙江省杭州市余杭区仓前街道浙江省杭州市余杭区仓前街道向往街1008号9幢601室"
                    }
                }
            ]
        }
    }
}
```
#### 错误返回：
```
{
    "msg": "入参错误",
    "success": false, 
    "code": 400, 
    "data": { }
}
```

#### provideAssuranceList：对外提供保证担保信息
|  字段名 | 说明  |  
| ------------ | ------------ |
| assuranceDurn | 保证的期间
| assuranceType | 保证的方式
| assuranceScope | 保证担保的范围
| creditor | 债权人 
| debtor | 债务人
| creditorCategory| 主债权种类
| creditorAmount| 主债权数额
| fulfillObligation| 履行债务的期限

#### stockChangeList：股权变更信息
|  字段名 | 说明  |  
| ------------ | ------------ |
|after|变更后股权比例
| changeDate | 股权变更日期
| name | 股东
| before | 变更前股权比例

#### socialSecurity：社保信息
|  字段名 | 说明  |  
| ------------ | ------------ |
| insuranceName | 保险种类、名称
| insuranceBase | 保险缴费基数
| insuranceRealCapital | 实际缴费金额
| insuranceArrearage| 累计欠缴金额
| insuranceAmount | 参保人数

#### webSiteList
|  字段名 | 说明  |  
| ------------ | ------------ |
| type | 网站类型
| name | 名称
| webSite | 网址


#### items
|  字段名 | 说明  |  
| ------------ | ------------ |
| year | 报送年度
| hasDetailInfo | 是否有详细信息
| publishDate | 发布日期
| basicInfoData | 企业基本信息
| changeList | 修改记录
| investInfoList | 对外投资信息
| partnerList| 股东（发起人）及出资信息
| provideAssuranceList|对外提供保证担保信息
| stockChangeList| 股权变更信息
| webSiteList | 网站或网店信息
| assetsData | 企业资产状况信息
| socialSecurity | 社保信息

#### basicInfoData：企业基本信息
|  字段名 | 说明  |  
| ------------ | ------------ |
| hasProvideAssurance| 是否有对外担保信息
| operationPlaces | 经营场所
| mainType | 主体类型
| regNo | 注册号
| companyName | 企业名称
| operatorName | 经营者姓名
| contactNo | 企业联系电话
| postCode | 邮政编码
| address | 企业通信地址
| emailAddress | 电子邮箱
| isStockRightTransfer|有限责任公司本年度是否发生股东股权转让
| status | 企业经营状态
| hasWebSite | 是否有网站或网店
| hasNewStockOrByStock|企业是否有投资信息或购买其他公司股权
| employeeCount | 从业人数
| belongTo | 隶属关系
| capitalAmount | 资金数额
| operationDuration | 经营期限

#### assetsData：企业资产状况信息
|  字段名 | 说明  |  
| ------------ | ------------ |
| totalProfit | 利润总额
| mainBusinessIncome|主营业务收入
| netProfit | 净利润
| totalTaxAmount | 纳税总额
| totalLiabilities | 负债总额
| bankingCredit | 金融贷款
| governmentSubsidy| 获得政府扶持资金、补助
| totalAssets | 资产总额
| totalOwnersEquity | 所有者权益合计
| grossTradingIncome | 营业总收入

#### changeList：修改记录
|  字段名 | 说明  |  
| ------------ | ------------ |
|changeName | 修改事项
| before | 变更前内容
| after | 变更后内容
| changeDate | 变更日期

#### investInfoList：对外投资信息
|  字段名 | 说明  |  
| ------------ | ------------ |
| name | 投资设立企业或购买股权企业名称
| regNo | 注册号
| creditCode | 信用代码

#### partnerList：股东（发起人）及出资信息
|  字段名 | 说明  |  
| ------------ | ------------ |
| name | 股东/发起人
| shouldCapi | 认缴出资额
| shouldDate | 认缴出资时间
| shouldType | 认缴出资方式
| realCapi | 实缴出资额
| realDate | 实缴出资时间
| realType | 实缴出资方式

#### 返回字段说明：

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码  |   
| code  |成功为200，收费   | 
| msg  | code对应的说明描述   | 
| data  | 查询结果详细信息|  
|orderNo|订单号


#### code错误码说明
|  code |  说明 |
| ------------ | ------------ |
| 200  | 成功  |
| 400  | 参数错误   |
| 404  | 请求资源不存在   |
| 500  | 系统内部错误，请联系服务商   |
| 501  |第三方服务异常
| 601  | 服务商未开通接口权限 |
| 602  | 账号停用 |
| 603  | 余额不足请充值 |
| 604  | 接口停用 |
|1001|其他，以实际返回为准
|1003|查无记录

返回参数 （暂无返回参数）

返回参数说明

|  字段名 | 说明  |  
| ------------ | ------------ |
| success  | 接口请求成功标识，true为成功，false为失败，失败情况下，会有对应描述和状态码  |   
| code  |成功为200，收费   | 
| msg  | code对应的说明描述   | 
| data  | 查询结果详细信息|  
|orderNo|订单号