公司抬头可见性分页查询
说明
提供对公司抬头可见性的查询接口。控制请求参数可见性类型（员工或部门），返回公司抬头该类型可见性的员工或部门信息。
接口限制
1. 10次/秒;
接口地址
/api/openapi/legalEntity/list/legal-entity/auth-scope
请求类型
POST
请求参数
请求参数说明
| 参数名称 |
类型 |
是否必填 |
说明 |
| bizCode |
String |
是 |
关键词，仅限填写公司抬头的业务编码 |
| type |
String |
是 |
类型，STAFF：员工； DEPARTMENT：部门 |
| pageNo |
int |
是 |
页面起始页，最小为1 |
| pageSize |
int |
是 |
页面大小，最大值是50 |
请求参数样例
{
"bizCode":"lcytest",
"type":"STAFF",
"pageSize":50,
"pageNo":1
}
响应参数
响应参数样例
{
"code": "ACK",
"message": "成功",
"data": {
"invoiceTitleZh": "公司抬头名称",
"invoiceTitleEn": null,
"dataAuthz": [
{
"bizCode": "001",
"type": "EMPLOYEE",
"name": "小红",
"nameEn": "111 222 3333",
"includeChildDept": true
},
{
"bizCode": "002",
"type": "EMPLOYEE",
"name": "小明",
"nameEn": "111 222 3333",
"includeChildDept": true
}
],
"pageNum": 1,
"pageSize": 50,
"size": 10,
"total": 10,
"pages": 1,
"firstPage": 1,
"prePage": 0,
"nextPage": 0,
"lastPage": 1,
"navigatePages": 2,
"startRow": 1,
"endRow": 10,
"isFirstPage": true,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"hasMore": false
},
"errorCode": null,
"success": true
}
响应参数说明
| 参数名称 |
类型 |
是否必填 |
说明 |
| invoiceTitleZh |
String |
是 |
公司抬头中文名称 |
| invoiceTitleEn |
String |
是 |
公司抬头英文名称 |
| dataAuthz |
List<dataAuthz> |
否 |
可见性 |
dataAuthz 参数说明
| 参数名称 |
类型 |
是否必填 |
说明 |
| bizCode |
String |
是 |
部门编码/员工工号 |
| type |
String |
是 |
类型。EMPLOYEE:员工；DEPARTMENT:部门 |
| name |
String |
是 |
部门名称/员工姓名 |
| nameEn |
String |
是 |
部门名称/员工姓名（英文） |
| includeChildDept |
Boolean |
否 |
当type=DEPARTMENT时返回，选择的父部门是否包含其子部门 |