# 接口说明
- 1.最新接口
- 2.支持批量更新法人主体,入参数据每次最多支持50条
- 3.批量更新时法人主体id不可重复
| 请求方式 | 请求地址 |
|---|---|
| POST | /openapi/func/legal/entity/update |
请求参数:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| timestamp | 时间戳 | long | Y | 13位时间戳 |
| sign | 签名 | string | Y | 4ergfdsawesf |
| access_token | token | string | Y | 登录 token |
| data | 请求数据 | jsonArray | Y | 请求数据 |
| data.type | 纳税人类型 | int | N | 1、一般纳税人2、小规模纳税人 |
| data.third_parent_id | 上级法人主体id | string | N | 为空时,法人主体为一级目录 |
| data.third_id | 法人主体三方系统ID | string | Y | 法人主体三方系统ID,不可重复 |
| data.state | 状态 | int | N | 1、启用 0、停用 |
| data.phone | 固定电话 | striing | N | 固定电话 |
| data.name | 企业名称 | string | Y | 企业名称,不可重复 |
| data.identification_number | 纳税人识别号 | string | Y | 不可重复 |
| data.code | 业务编码 | string | N | 业务编码 |
| data.bank_name | 开户行 | string | N | 开户行 |
| data.bank_code | 银行账号 | string | N | 银行账号 |
| data.address | 注册地址 | string | N | 注册地址 |
请求示例:
"access_token": "xxx.xxx.xxx",
"timestamp": 1596697247000,
"employee_id":"third_jianyuan",
"employee_type":"1",
"sign": "83su83jld83ujdmsliemxkoncksow",
"data":
[{
"third_id": "hetest003",
"name": "法人实体名称测试0001",
"identification_number": "2022042400001",
"code": "7687898",
"third_parent_id": "56757678",
"type": 1,
"bank_name": "中国银行",
"bank_code": "6887988989",
"address": "北京市朝阳区***",
"phone": "13987654321"
}, {
"third_id": "hetest004",
"name": "法人实体名称测试0001",
"identification_number": "2022042400002",
"type": 1,
"code": "7687898",
"third_parent_id": "56757678",
"bank_name": "中国银行",
"bank_code": "6887988989",
"address": "北京市朝阳区***",
"phone": "13987654321"
}]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
返回参数:
| 字段 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| trace_id | 请求id | string | Y | |
| code | 响应码 | string | Y | 枚举值 -9999:全部失败 0:全部成功 1:部分成功 |
| msg | 响应信息 | string | Y | 响应码(code)为-9999时,显示错误信息;为0时,显示成功;为1时,显示部分错误,详情参见data |
| data | 响应数据 | jsonObject | N | 错误信息 |
| data.third_id | 法人主体三方id | string | N | 法人主体三方id |
| data.error_msg | 错误信息 | string | N | 错误信息 |
成功返回示例
{
"trace_id": "c518a3d49e5d4d85968bde12a9f1d34b.390.16541403050720102",
"code": 0,
"msg": "success",
"data": {},
"request_id": "ymego5rnp5k7e4il"
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
失败返回示例
{
"trace_id": "c518a3d49e5d4d85968bde12a9f1d34b.390.16541403050720101",
"code": -9999,
"msg": "操作法人实体信息全部失败",
"data": [
{
"third_id": "hetest003",
"error_msg": "参数中有字段重复,不予修改"
},
{
"third_id": "hetest004",
"error_msg": "参数中有字段重复,不予修改"
}
],
"request_id": "ymego5rnp5k7e4il"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17