1.个体户接口
## 1.1.1 创建法人信息接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/createSelfInfo
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String|是||
|name|姓名|String|是||
|mobile|手机号|String|是||
|frontIdCard|身份证正面照URL|String|是||
|backIdCard|身份证反面照URL|String|是||
|hatlessPhoto|人脸照URL|String|是||
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|token|个体户token|String|是|该token有效期为2小时,如果失效则需要重新调用3.获取token接口获取|
## 1.1.2. 创建个体户接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/createSelfEmployed/{token}
>d token直接拼接至接口 例如：token 为 xxxxx 则请求链接为 /open/api/v1/selfRegistered/createSelfEmployed/xxxxx
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|source|所属业务线|Integer|是|2：轻税 3：账管家 4:云纳税|
|mainstayId|主体ID|Integer|是||
|industryCode|行业code|String|是||
|invoices|发票类目code|String|是|多个用逗号隔开。但是必须都是所属于同一行业|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|状态|Integer|是|[开户状态码](doc:KskSPDLn)|
|failReason|失败原因|String|是|开户失败该值会有失败原因|
## 1.2. 创建法人+个体户接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/create
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|source|所属业务线|Integer|是|2：轻税 3：账管家 4:云纳税|
|name|个体户姓名|String|是|例：张三|
|idCard|个体户身份证号|String|是|例：4104xxxx51167|
|phone|个体户手机号|String|否|例：130xxxx3381|
|mainstayId|注册地|String|是|[5.2.查询企业合作主体，发票类目等信息](doc:3ec9IMsB)|
|invoiceCode|开票编码|String|是|可多选（必须属于同一行业），用英文逗号隔开。[5.2.查询企业合作主体，发票类目等信息](doc:3ec9IMsB)|
|industryCode|所属行业code|String|是|[5.2.查询企业合作主体，发票类目等信息](doc:3ec9IMsB)|
|taxType|个税算法|String|否|业务线【轻税、账管家】需要必传 0:累进制 2:双定制|
|idCardFrontUrl|身份证正面|String|否|URL地址|
|idCardBackUrl|身份证反面|String|否|URL地址|
|facePhotoUrl|人脸照|String|否|URL地址|
#### 接口响应参数data字段解密后的参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|个体户状态|Integer|是|[开户状态码](doc:KskSPDLn)|
|failReason|失败原因|String|是|该参数内容可能为空，成功的时候失败原因为空字符串|
## 1.3.1. 个体户信息查询接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/querySelfEmployedInfo/{token}
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mainstayId|主体ID|Integer|是||
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|name|法人姓名|String|是||
|idCard|法人身份证号码|String|是||
|status|状态|Integer|是|[个体户状态码](doc:KskSPDLn)|
|taxStatus|税务状态|Integer|是|0:未实名，1:已实名。该状态为已实名才可进行开票操作|
|taxType|税算法类型|Integer|是|0累进制、1核定制|
|refuseType|拒绝类型|Integer|否||
|refuseReason|审核拒绝原因|String|否||
|companyName|个体户公司名称|String|是||
|taxNumber|税号|String|否|个体户注册成功之后才会有税号|
|mobile|注册手机号码|String|是||
|address|注册地址|String|是||
|businessLicense|营业执照|String|否|个体户注册成功之后才会有|
|entrustProtocol|个体户协议|String|否|个体户签名之后才会有|
## 1.3.2.个体户信息查询接口（简化版)
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/selfEmployedQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|个体户身份证号|String(18)|是||
|mainstayId|注册地|Integer(2)|是||
|source|所属业务线|Integer(2)|是|2:轻税 3:账管家 4:云纳税|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status| 个体户状态|Integer|是|个体户状态请查阅：[个体户查询状态码](doc:KskSPDLn)|
|taxStatus|税务状态|Integer|是|0：未实名，1：已实名。当该状态变为“已实名”后才可以进行开票申请操作||
|isRefuse| 是否审核拒绝 0:未拒绝 1：审核拒绝|String|是|当个体户审核拒绝时候，该参数值为 1(表示审核拒绝)。个体户状态（status）参数依旧为 -1（待申请状态）。|
|name|个体户姓名|String|是|例：张三|
|idCard|个体户身份证号|String|是|例：410422199405051167|
|mainstayName|注册地|String|是|例：长兴|
|companyName|公司名|String|是|例：xxxx有限公司|
|taxNumber|纳税人识别号|String|否|例：91330100FS234（纳税人识别号）|
|phoneAddress|手机号、地址|String|否|例：浙江省杭州市滨江区网商路xx号 130xxxx3381|
|bankNameAccount|开户行及账户信息|String|否|例：中国工商银行杭州富春支行 330501164xxxxxxx|
|license| 营业执照|String|否|例：https://qiniu.lx-rhino.com/XXXX|
|failReason| 异常原因|String|否|该参数内容可能为空，成功的时候失败原因为空字符串|
|taxType|个税类型|Integer|是|0 累进制、1 核定制 2、双定制|
|entrustProtocol|个体户协议|String|否|个体户签名之后才会有|
## 1.3.3.个体户信息查询接口（批量）
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/qsSelfEmployedBatchQuery
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCards|身份证号码|List<String>|是|身份证号码数组，身份证个数不可超过100个|
|mainstayId|主体ID|Integer|是|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|selectStatus|是否查询到|boolean|是|false：未查询到 true：查询到了|
|idCard|身份证号码|String|是||
|name|姓名|String|个体户存在必传||
|mainstayName|注册地|String|个体户存在必传||
|status|个体户状态|Integer|个体户存在必传|[个体户状态码](doc:KskSPDLn)|
|taxStatus|税务状态|Integer|个体户存在必传|0:未实名，1:已实名。该状态为已实名才可进行开票操作|
|taxType|税算法类型|Integer|个体户存在必传|0累进制、1核定制|
|isRefuse|审核拒绝|Integer|个体户存在必传|0:未拒绝 1：审核拒绝||
|companyName|个体户公司名称|String|个体户存在必传||
|bankNameAccount|开户行及账户信息|String|个体户存在必传||
|taxNumber|税号|String|否|个体户存在必传，且个体户注册成功之后才会有税号|
|phoneAddress|手机号、注册地|String|个体户存在必传||
|license|营业执照|String|否|个体户存在必传，且个体户注册成功之后才会有|
|failReason|异常原因|String|否|
|source|所属业务线|Integer|个体户存在必传|2:轻税 3:账管家 4:云纳税|
|entrustProtocol|个体户协议|String|否|个体户存在必传，且个体户签名之后才会有|
## 1.4.个体户注销接口
开发环境：https://pay-dev.lx-rhino.com
生产环境：https://api.lx-rhino.com
#### 接口地址：/open/api/v1/selfRegistered/selfEmployedLogout
#### 请求方式：POST
#### 请求参数说明：
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|idCard|身份证号码|String|是|
|mainstayId|主体ID|Integer|是|
|source|业务线|Integer|业务线| 2轻税,3账管家,4云纳税|
#### 接口响应参数说明：
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|个体户状态|Integer|是|40:注销中,注销中代表调用接口成功,等待系统处理即可|
|needPay|是否需要支付|boolean|是|ture:需要支付注销费，false:无需支付注销费|
|transNo|注销费支付订单号|String|否|只要当需要支付的时候该字段才有值|
|payAmount|注销费|BigDecimal|否|只要当需要支付的时候该字段才有值|
|agencyTransNos|季度服务费支付订单号|List<String>|否|只要当需要支付的时候该字段才有值|
|agencyPayAmount|季度服务费|BigDecimal|否|只要当需要支付的时候该字段才有值|
|totalPayAmount|总支付金额|BigDecimal|否|只要当需要支付的时候该字段才有值|