公司抬头查询
说明
该接口用于查询公司抬头。
接口限制
1. 10次/秒;
接口地址
/api/openapi/legalEntity/data?updateStart={updateStart}&updateEnd={updateEnd}
请求类型
GET
请求参数
参数说明
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| updateStart | long | 否 | 根据更新时间，返回（包括）之后的数据 |
| updateEnd | long | 否 | 根据更新时间，返回（包括）之前的数据 |
参数样例
/api/openapi/legalEntity/data?updateStart=1667418287000&updateEnd=1670010287000
响应参数
参数说明
公司抬头主体参数说明：
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| invoiceTitle | string | 是 | invoiceTitleZh的别名，功能作用完全一致。 |
| invoiceTitleZh | string | 是 | 公司抬头名称中文名称 |
| invoiceTitleEn | string | 是 | 公司抬头名称英文文名称 |
| bizCode | string | 是 | 业务编码 |
| dutyParagraph | string | 是 | 税号 |
| address | string | 是 | 公司抬头地址 |
| phone | string | 是 | 电话 |
| account | string | 是 | 银行账户 |
| bankBranchName | string | 是 | 开户行 |
| baseCurrencyCode | string | 是 | 本币币种符号 |
| alternateInvoiceTitle | string | 是 | alternateInvoiceTitleZh的别名，功能作用完全一致。 |
| alternateInvoiceTitleZh | string | 是 | 备用名称中文 |
| alternateInvoiceTitleEn | string | 是 | 备用名称英文 |
| alternateFailureTime | Long | 是 | 备用名称失效时间 |
| dataAuth | array | 是 | 选项可见性 |
| affiliatedCompanyList | array | 是 | 所属公司（这里公司指的是在每刻具有公司性质的部门） |
| createdAt | long | 是 | 创建时间 |
| updatedAt | long | 是 | 更新时间 |
| acceptCcys | array | 是 | 收款币种（空表示不限制）.币种映射表 |
| i18nInvoiceTitle | I18nName.md | 否 | 公司抬头多语言名称。key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的名称。仅返回系统已启用的语言，未启用的语言不返回。已启用但未维护的语言返回空字符串 |
| i18nAlternateInvoiceTitle | I18nName.md | 否 | 备用抬头多语言名称。key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的名称。仅返回系统已启用的语言，未启用的语言不返回。已启用但未维护的语言返回空字符串 |
dataAuth可见性参数说明：
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| bizCode | string | 是 | 业务编码（员工工号或部门业务编码） |
| type | string | 是 | 可见性类型，可选值如下: STAFF（人员） DEPARTMENT（部门） |
| includeChildDept | bool | 是 | 是否包含子部门（部门） |
affiliatedCompanyList参数说明：
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| bizCode | string | 是 | 具有公司性质的部门业务编码 |
参数样例
{
"code": "ACK",
"message": null,
"data": [
{
"invoiceTitle": "导出测试中文名",
"invoiceTitleZh": "导出测试中文名",
"invoiceTitleEn": "导出测试英文名",
"dutyParagraph": "190214627",
"bizCode": "tgr666",
"address": "江西省上饶市",
"phone": "07968888666",
"account": "62122642000",
"bankBranchName": "鄱阳开户行",
"baseCurrencyCode": "CNY",
"alternateInvoiceTitle": "备用中文名",
"alternateInvoiceTitleZh": "备用中文名",
"alternateInvoiceTitleEn": "备用英文名",
"alternateFailureTime": 1659004717634,
"createdAt": 1669804799765,
"updatedAt": 1669804799765,
"dataAuth": [
{
"bizCode": "DI2112161H570RZN-tgr",
"type": "DEPARTMENT",
"includeChildDept": true
},
{
"bizCode": "DI2112231XRKWKJRtgr",
"type": "DEPARTMENT",
"includeChildDept": true
},
{
"bizCode": "DI2205191DG0EB9C",
"type": "DEPARTMENT",
"includeChildDept": true
},
{
"bizCode": "test00311",
"type": "DEPARTMENT",
"includeChildDept": true
},
{
"bizCode": "200059",
"type": "STAFF"
},
{
"bizCode": "200129",
"type": "STAFF"
}
],
"affiliatedCompanyList": [
{
"bizCode": "DI2112231XRKWKJRtgr",
"name": "A前端组"
},
{
"bizCode": "DI2112161H570RZE",
"name": "公共集成组部门1"
}
],
"acceptCcys": [
"AED",
"ALL",
"USD"
],
"i18nInvoiceTitle": {
"ja": "",
"en": "",
"zh": ""
},
"i18nAlternateInvoiceTitle": {
"ja": "",
"en": "",
"zh": ""
}
},
{
"invoiceTitle": "测试校验",
"invoiceTitleZh": "测试校验",
"dutyParagraph": "6461613",
"bizCode": "ELC2201171C21CGLC",
"account": "",
"baseCurrencyCode": "CNY",
"acceptCcys": []
},
{
"invoiceTitleEn": "sscc",
"dutyParagraph": "3443443234",
"bizCode": "ELC2201171C03WQ9S",
"account": "",
"baseCurrencyCode": "CNY",
"acceptCcys": []
}
],
"errorCode": null,
"success": true
}
修改记录
2022-11-30 增加更新时间作为查询条件，增加返回createdAt创建时间,updatedAt更新时间字段如果更新字段为空默认都会返回
2022-11-15 增加收款币种参数
2026-07-22 增加 i18nInvoiceTitle、i18nAlternateInvoiceTitle 字段