批量导入公司抬头信息
业务场景
该接口用于批量更新或保存公司抬头信息，同时可以设置公司抬头对员工或者部门的可见性。
接口说明
- 单次导入限制为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 | 否 | 收款币种（不传默认不限制）.币种映射表 |
| i18nInvoiceTitle | I18nName.md | 否 | 公司抬头多语言名称。 key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的名称。仅支持系统已启用的语言，未启用语言不支持传入。 传中英文请使用 invoiceTitleZh字段、invoiceTitleEn 字段。 该字段不传则所有语言维持原数据。某语言传入具体值则更新该语言名称，不传则维持该语言原数据，传入空字符串则清除该语言原数据。 |
| i18nAlternateInvoiceTitle | I18nName.md | 否 | 备用抬头多语言名称。 key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的名称。仅支持系统已启用的语言，未启用语言不支持传入。 传中英文请使用 alternateInvoiceTitleZh 字段、alternateInvoiceTitleEn 字段。 该字段不传则所有语言维持原数据。某语言传入具体值则更新该语言名称，不传则维持该语言原数据，传入空字符串则清除该语言原数据 |
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
},
"i18nInvoiceTitle": {
"zh": "",
"en": "",
"ja": ""
},
"i18nAlternateInvoiceTitle": {
"zh": "",
"en": "",
"ja": ""
}
},
{
"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
}
修改记录
新建 批量导入公司抬头信息文档
2026-07-22 增加 i18nInvoiceTitle、i18nAlternateInvoiceTitle 字段