个体户注册接口

## 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|否|只要当需要支付的时候该字段才有值|