# 接口说明

  • 1.最新接口
  • 2.支持批量新增法人主体,入参数据每次最多支持50条
  • 3.批量新增时法人主体id不可重复
请求方式 请求地址
POST /openapi/func/legal/entity/create

请求参数:

字段 名称 类型 必填 描述
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

返回参数:

字段 名称 类型 必填 描述
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

失败返回示例

{
    "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
lastUpdate: 6/8/2022, 6:11:44 PM