批量导入附属公司抬头信息
业务场景
该接口用于批量更新或保存附属公司抬头信息。
接口说明
- 单次导入限制为20条公司抬头数据，每个公司抬头包含50条附属公司抬头
- 本接口采用部分失败模式，一条数据失败不影响其他正确数据
接口限制
10次/秒/企业
接口地址
/api/openapi/legalEntity/auxiliaries/save
请求类型
POST
请求参数
参数说明
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| legalEntityBizCode | string | 是 | 公司抬头业务编码 |
| legalEntityAuxiliaries | array | 是 | 附属公司抬头信息 |
legalEntityAuxiliaries附属公司抬头信息参数说明：
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| bizCode | string | 是 | 业务编码 |
| invoiceTitleZh | string | 中英文至少填一个，不填时视为维持原数据，填写空串时视为清除原数据 | 附属公司抬头名称中文名称 |
| invoiceTitleEn | string | 中英文至少填一个，不填时视为维持原数据，填写空串时视为清除原数据 | 附属公司抬头名称英文文名称 |
| i18nInvoiceTitle | I18nName.md | 否 | 附属公司抬头多语言名称。 key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的名称。仅支持系统已启用的语言，未启用语言不支持传入。 传中英文请使用 invoiceTitleZh 字段、invoiceTitleEn 字段。 该字段不传则所有语言维持原数据。某语言传入具体值则更新该语言名称，不传则维持该语言原数据，传入空字符串则清除该语言原数据。 |
| dutyParagraph | string | 否 | 税号 |
参数示例
[
{
"legalEntityBizCode": "公司抬头业务编码",
"legalEntityAuxiliaries": [
{
"bizCode": "附属公司抬头业务编码",
"invoiceTitleZh": "附属公司抬头名称",
"invoiceTitleEn": "附属公司抬头英文名称",
"dutyParagraph": "附属公司抬头税号",
"i18nInvoiceTitle": {
"zh": "",
"en": "",
"ja": ""
}
}
]
}
]
响应参数
响应参数说明
| 字段 | 字段类型 | 字段说明 |
|---|---|---|
| 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 字段