个体户注册接口
## 1. 创建法人+个体户接口
开发环境: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|是|3.查询企业合作主体,发票类目等信息|
|invoiceCode|开票编码|String|是|可多选(必须属于同一行业),用英文逗号隔开。3.查询企业合作主体,发票类目等信息|
|industryCode|所属行业code|String|是|3.查询企业合作主体,发票类目等信息|
#### 接口响应参数data字段解密后的参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|status|个体户状态|Integer|是|[2.开户状态码](doc:6AvyKywX)|
|failReason|失败原因|String|是|该参数内容可能为空,成功的时候失败原因为空字符串|
## 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|是|个体户状态请查阅:[个体户查询状态码](https://easydoc.net/doc/95180784/Ry461Ra3/g5SDIGDl)|
|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|否|个体户签名之后才会有|
## 3.查询企业合作主体,发票类目等信息
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
#### 接口地址:/open/api/v1/selfRegistered/queryCompanyInfo
#### 请求方式:POST
#### 请求参数说明:无需传任何参数
#### 接口响应参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|source|所属业务线|Integer|是|2:轻税业务 3:账管家业务 4:云纳税|
|mainstayId|合作主体|Integer|是||
|name|合作主体名称|String|是||
|industryCode|所属行业code|String|是||
|industryName|所属行业名称|String|是||
|invoiceCode|发票编码|String|是||
|invoiceContent|发票内容|String|是||
>d 示例数据结构如下
```json
[{
"akMainstayOpResponses": [{
"invoiceOpResponseList": [{
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWXSZXF",
"invoiceContent": "物流辅助服务**运输装卸费"
}],
"mainstayId": 主体ID,
"name": "主体2"
}, {
"invoiceOpResponseList": [{
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWXSZXF",
"invoiceContent": "物流辅助服务**运输装卸费"
}],
"mainstayId": 主体Id,
"name": "主体3"
}, {
"invoiceOpResponseList": [{ //发票列表
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWXSZXF",
"invoiceContent": "物流辅助服务**运输装卸费"
}, {
"industryCode": "ZXBYFW",
"industryName": "装卸搬运服务",
"invoiceCode": "WLFZFWZXBYFW",
"invoiceContent": "物流辅助服务*装卸搬运服务"
}],
"mainstayId": 主体ID,
"name": "主体1"
}],
"source": 3 //所属业务线 账管家
}, {
"akMainstayOpResponses": [{
"invoiceOpResponseList": [{
"industryCode": "YXTG_01",
"industryName": "营销推广",
"invoiceCode": "XDFWCHFWF",
"invoiceContent": "现代服务*策划服务费"
}, {
"industryCode": "YXTG_01",
"industryName": "营销推广",
"invoiceCode": "XDFWTGFWF",
"invoiceContent": "现代服务*推广服务费"
}, {
"industryCode": "YXTG_01",
"industryName": "营销推广",
"invoiceCode": "XDFWYXFWF",
"invoiceContent": "现代服务*营销服务费"
}, {
"industryCode": "KJHY_01",
"industryName": "科技行业",
"invoiceCode": "XXJSFWJSFWF",
"invoiceContent": "信息技术服务*技术服务费"
}],
"mainstayId": 主体ID,
"name": "主体1"
}, {
"invoiceOpResponseList": [{
"industryCode": "WLGW_02",
"industryName": "管理&顾问",
"invoiceCode": "JZZXFWZXFWF",
"invoiceContent": "鉴证咨询服务*咨询服务费"
}, {
"industryCode": "YXTG_02",
"industryName": "营销推广",
"invoiceCode": "XDFWCHFWF",
"invoiceContent": "现代服务*策划服务费"
}],
"mainstayId":主体Id,
"name": "主体2"
}, {
"invoiceOpResponseList": [{
"industryCode": "WHZB_03",
"industryName": "网红&直播",
"invoiceCode": "XDFWHLWXXFW",
"invoiceContent": "现代服务*互联网信息服务"
}],
"mainstayId": 主体Id,
"name": "主体3"
}],
"source": 2 //所属业务线 轻税
}]
```
## 4.获取个体户H5免密登录接口
开发环境:https://pay-dev.lx-rhino.com
生产环境:https://api.lx-rhino.com
接口地址:/open/api/v1/selfRegistered/getTokenUrl
请求方式:POST
请求参数说明:
#### data数据中参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|mobile|手机号码|String|是||
#### 接口响应参数data字段解密后的参数说明:
|参数名称|参数含义| 数据类型|是否必有|参数备注|
|-|-|-|-|-|
|url|H5免密登录链接|String|是|有效时间2分钟,不可重复使用|
## 5. 个体户注销接口
#### 接口地址:/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|否|只要当需要支付的时候该字段才有值|