创建法人实体
POST
https://open.qfei.cn/open-apis/mdm/v1/legal_entities
请求说明：#
| 接口频率限制 | 1000 次/分钟、50 次/秒 |
|---|---|
| 权限要求 | 查看、创建、编辑主数据的法人实体相关信息 |
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Query 参数
Header 参数
Body 参数application/json必填
示例
{
"legalEntity": "L00002002",
"legalEntityText": "法人22",
"shortText": "legalPerson",
"certificationType": "0",
"certificationId": "",
"legalPerson": "张三",
"country": "CN",
"province": "MDPS00004000",
"city": "MDCY00006000",
"address": "地址",
"taxpayerType": "1",
"telephone": "",
"bankId": "MDBK00072319",
"bankName": "中原银行股份有限公司南阳华瑞支行",
"bankAccount": "644666446",
"status": 1,
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
],
"legalEntityBanks": [
{
"companyCode": "1002",
"bankId": "MDBK00131739",
"bankCode": "001755053005",
"bankName": "中国人民银行丽江市中心支行",
"bankAcronym": "PBC",
"country": "CN",
"accountName": "账户名称",
"bankAccount": "122907287xxxxx9",
"swiftCode": "CMBCCNBS",
"bankControlCode": "40001xxxxxxx00313261",
"extendInfo": [
{
"fieldType": 0,
"fieldValue": "文本值",
"options": [
""
],
"num": 1.11,
"date": "2021-10-14",
"rangeDate": [
""
],
"fieldCode": "LXX0000001",
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
]
}
],
"ibanAccount": "6446777"
}
],
"extendInfo": [
{
"fieldType": 0,
"fieldValue": "文本值",
"options": [
""
],
"num": 1.11,
"date": "2021-10-14",
"rangeDate": [
""
],
"fieldCode": "T0001",
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
]
}
]
"accountName": "12",
"bankControlCode": "12",
"swiftCode": "123",
"clearingAccount": "12333"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.qfei.cn/open-apis/mdm/v1/legal_entities?user_id=123123123123123&user_id_type=user_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"legalEntity": "L00002002",
"legalEntityText": "法人22",
"shortText": "legalPerson",
"certificationType": "0",
"certificationId": "",
"legalPerson": "张三",
"country": "CN",
"province": "MDPS00004000",
"city": "MDCY00006000",
"address": "地址",
"taxpayerType": "1",
"telephone": "",
"bankId": "MDBK00072319",
"bankName": "中原银行股份有限公司南阳华瑞支行",
"bankAccount": "644666446",
"status": 1,
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
],
"legalEntityBanks": [
{
"companyCode": "1002",
"bankId": "MDBK00131739",
"bankCode": "001755053005",
"bankName": "中国人民银行丽江市中心支行",
"bankAcronym": "PBC",
"country": "CN",
"accountName": "账户名称",
"bankAccount": "122907287xxxxx9",
"swiftCode": "CMBCCNBS",
"bankControlCode": "40001xxxxxxx00313261",
"extendInfo": [
{
"fieldType": 0,
"fieldValue": "文本值",
"options": [
""
],
"num": 1.11,
"date": "2021-10-14",
"rangeDate": [
""
],
"fieldCode": "LXX0000001",
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
]
}
],
"ibanAccount": "6446777"
}
],
"extendInfo": [
{
"fieldType": 0,
"fieldValue": "文本值",
"options": [
""
],
"num": 1.11,
"date": "2021-10-14",
"rangeDate": [
""
],
"fieldCode": "T0001",
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
]
}
]
"accountName": "12",
"bankControlCode": "12",
"swiftCode": "123",
"clearingAccount": "12333"
}'返回响应
🟢200成功
application/json
Body
示例
{
"code": 0,
"msg": "success",
"data": {
"legalEntity": "L00002002",
"legalEntityText": "法人22",
"shortText": "legalPerson",
"certificationType": "0",
"certificationId": "",
"legalPerson": "张三",
"country": "CN",
"province": "MDPS00004000",
"city": "MDCY00006000",
"address": "地址",
"taxpayerType": "1",
"telephone": "",
"bankId": "MDBK00072319",
"bankName": "中原银行股份有限公司南阳华瑞支行",
"bankAccount": "644666446",
"status": 1,
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
],
"legalEntityBanks": [
{
"id": "1433492736852541442",
"companyCode": "1002",
"bankId": "MDBK00131739",
"bankCode": "001755053005",
"bankName": "中国人民银行丽江市中心支行",
"bankAcronym": "PBC",
"country": "CN",
"accountName": "账户名称",
"bankAccount": "122907287xxxxx9",
"swiftCode": "CMBCCNBS",
"bankControlCode": "40001xxxxxxx00313261",
"extendInfo": [
{
"fieldType": 0,
"fieldValue": "文本值",
"options": [
""
],
"num": 1.11,
"date": "2021-10-14",
"rangeDate": [
""
],
"fieldCode": "LXX000001",
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
]
}
],
"ibanAccount": "6446777"
}
],
"extendInfo": [
{
"fieldType": 0,
"fieldValue": "文本值",
"options": [
""
],
"num": 1.11,
"date": "2021-10-14",
"rangeDate": [
""
],
"fieldCode": "LXX0000001",
"appendix": [
{
"tenantId": "6977354570259330000",
"fileId": "609a128628ad4eaebd3063c59928a103",
"fileName": "xxxx.xlsx",
"fileType": "XLSX",
"fileSize": 13367,
"downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
}
]
}
],
"accountName": "12",
"bankControlCode": "12",
"swiftCode": "123",
"clearingAccount": "12333"
}
}修改于 2025-11-17 09:23:55