5.个体户接口文档
## 5.1 个体工商户可结算金额查询
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/qs/qsSelfEmployedSettledAmountQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String|是||
|mainstayId|注册地ID|String|是|该参数值由4.4 查询发票信息与主体信息接口|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|name|个体户姓名|String|是|例：张三|
|idCard|个体户身份证号|String|是|例：410422199405051167|
|thisMonthSettledAmount|本月已结算金额|String|是|例：0|
|thisMonthSurplusOfAmount|本月剩余可结算金额|String|是|例：400000|
|surplusOfInvoiceAmount|剩余可开票金额|String|是|例：4950000|
#### 字段解释：
（1）剩余可开票金额：指的是记录个体工商户剩余可开发票的金额，由于个体工商户开票年度总金额的限制的原因；开票年度计算方式，个体工商户连续12月开票金额不得超过495W，例如：从2021年3月份往前推12个月的开票金额不得超过495W，4月份依次类推。例如：495W - 2020年4月份到2021年的3月份之前开票的金额 = 剩余可开票金额；
## 5.2 个体户可结算金额查询（批量）
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/qs/qsSelfEmployedSettledAmountBatchQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCards|个体户身份证号|List<String>|是||
|mainstayId|注册地ID|String|是|该参数值由4.4 查询发票信息与主体信息接口|
#### 接口响应参数说明：
>d 1. 响应的data是一个数组
> 2. 批量查询最多入参查询人数为100人
```json
[
{
"name":"张三",
"idCard":"410422199405051167",
"thisMonthSettledAmount":0,
"thisMonthSurplusOfAmount":400000,
"surplusOfInvoiceAmount":4950000,
"queryStatus":true,
"failReason":"xxx",
},
...
]
```
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|name|个体户姓名|String|是|例：张三|
|idCard|个体户身份证号|String|是|例：410422199405051167|
|thisMonthSettledAmount|本月已结算金额|BigDecimal|是|例：0|
|thisMonthSurplusOfAmount|本月剩余可结算金额|BigDecimal|是|例：400000|
|surplusOfInvoiceAmount|剩余可开票金额|BigDecimal|是|例：4950000|
|queryStatus|查询状态|Boolean|是|个体户查询状态：成功返回true，失败返回false|
|failReason|查询失败原因|String|否|个体户查询失败时此字段会返回失败原因|
#### 字段解释：
（1）剩余可开票金额：指的是记录个体工商户剩余可开发票的金额，由于个体工商户开票年度总金额的限制的原因；开票年度计算方式，个体工商户连续12月开票金额不得超过495W，例如：从2021年3月份往前推12个月的开票金额不得超过495W，4月份依次类推。例如：495W - 2020年4月份到2021年的3月份之前开票的金额 = 剩余可开票金额；