批量导入公司抬头信息
业务场景
该接口用于批量更新或保存公司抬头信息，同时可以设置公司抬头对员工或者部门的可见性。
接口说明
- 单次导入限制为100条数据
- 本接口采用部分失败模式，一条数据失败不影响其他正确数据
接口限制
10次/秒/企业
接口地址
/api/openapi/legalEntity/data/detail
请求类型
POST
请求参数
参数说明
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| invoiceTitle |
string |
否 |
invoiceTitleZh的别名，功能作用完全一致 |
| invoiceTitleZh |
string |
中英文至少填一个，不填时视为维持原数据，填写空串时视为清除原数据 |
公司抬头名称中文名称 |
| invoiceTitleEn |
string |
中英文至少填一个，不填时视为维持原数据，填写空串时视为清除原数据 |
公司抬头名称英文文名称 |
| bizCode |
string |
是 |
业务编码 |
| dutyParagraph |
string |
否 |
税号 |
| address |
string |
否，不填时视为维持原数据，填写空串时视为清除原数据 |
公司抬头地址 |
| phone |
string |
否，不填时视为维持原数据，填写空串时视为清除原数据 |
电话 |
| account |
string |
否，不填时视为维持原数据，填写空串时视为清除原数据 |
银行账户 |
| bankBranchName |
string |
否，不填时视为维持原数据，填写空串时视为清除原数据 |
开户行 |
| baseCurrencyCode |
string |
否，新增公司抬头不填时默认是CNY(人民币)，无法修改原币种 |
本币币种符号 |
| alternateInvoiceTitle |
string |
否 |
alternateInvoiceTitleZh的别名，功能作用完全一致 |
| alternateInvoiceTitleZh |
string |
否，不填时视为维持原数据，填写空串时视为清除原数据 |
备用名称中文 |
| alternateInvoiceTitleEn |
string |
否，不填时视为维持原数据，填写空串时视为清除原数据 |
备用名称英文 |
| alternateFailureTime |
date |
否，13位时间戳，失效时间新增不，填视为永久有效，修改不填视为维持原数据 |
备用名称失效时间 |
| includeChildDept |
Boolean |
否，默认值false |
是否包含下级子部门 |
| dataAuthz |
array |
否，不填时视为维持原数据，填写空数组时视为清除原数据 |
选项可见性 |
| affiliatedCompanyList |
array |
否，不填时视为维持原数据，填写空数组时视为清除原数据 |
所属公司（这里公司指的是在每刻具有公司性质的部门） |
| acceptCcys |
array |
否 |
收款币种（不传默认不限制）.币种映射表 |
dataAuth可见性参数说明：
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| bizCode |
string |
是 |
业务编码（员工工号或部门业务编码） |
| type |
string |
是 |
可见性类型，可选值如下STAFF（人员）DEPARTMENT（部门） |
affiliatedCompanyList参数说明：
| 字段名称 |
字段类型 |
是否必填 |
字段说明 |
| businessCode |
string |
是 |
具有公司性质的部门业务编码 |
参数示例
[
{
"invoiceTitle": "公司抬头a",
"dutyParagraph": "abc1234",
"bizCode": "import001",
"dataAuthz": [
{
"bizCode": "190013",
"type": "STAFF"
},
{
"bizCode": "DI1810191A22Q8M0",
"type": "DEPARTMENT"
}
],
"address": "地址",
"bankBranchName": "工商银行",
"phone": "1234567890",
"account": "622222213455667",
"baseCurrencyCode": "USD",
"includeChildDept": true,
"extraProperties": {
"aaaa": "1",
"bbb": "2",
"ccc": 3
}
},
{
"invoiceTitle": "公司抬头b",
"dutyParagraph": "abc2345",
"bizCode": "import002",
"dataAuthz": [
{
"bizCode": "190013",
"type": "STAFF"
},
{
"bizCode": "DI1810191A22Q8M0",
"type": "DEPARTMENT"
}
],
"address": "地址",
"bankBranchName": "工商银行",
"phone": "1234567890",
"account": "622222213455667",
"baseCurrencyCode": "USD",
"includeChildDept": false,
"extraProperties": {
"aaaa": "1",
"bbb": "2",
"ccc": 3
}
}
]
响应参数
响应参数说明
| 字段 |
字段类型 |
字段说明 |
| code |
String |
返回结果 |
| message |
String |
返回提示 |
| data |
Json |
返回结果 |
| success |
boolean |
是否成功 |
正常响应参数示例
{
"code": "ACK",
"message": "保存成功！",
"data": null,
"success": null
}
异常响应参数示例
{
"code": "NACK",
"message": "企业名称重复，请更改",
"data": null,
"errorCode": null,
"success": false
}
修改记录
新建 批量导入公司抬头信息文档