---
title: "外部联系人查询"
docId: "852991899761672192"
source: "https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/91f5067f-775e-48f4-93a2-ce84ca0b9c2e/doc/852991899761672192"
---
## 1. 外部联系人查询(返回主信息)

```java
// 本地接口
com.weaver.common.hrm.service.external.HrmCommonExternalEmployeeService#queryExternalEmpIdsByCondition
```

- HrmExternalEmpContidition 参数说明
  
  | 参数 | 说明 | 是否必填 |
  | --- | --- | --- |
  | contactIds | 客户联系人 |  |
  | customerIds | 客户id |  |
  | empStatusList | 人员状态：UserStatus枚举 |  |
  | nullContract | 是否值查询客户联系人未空的数据 |  |

## 2. 外部联系人查询(主信息+扩展信息)

```java
-- rpc接口（weaver-common-hrm）
com.weaver.common.hrm.remote.external.HrmRemoteExternalService#queryEmpListForAccountTypeByExtEmployee

-- 本地接口（weaver-common-hrm）
com.weaver.common.hrm.service.external.HrmCommonExternalEmployeeService#queryEmpListForAccountTypeByExtEmployee
```

- 入参说明
  
  | 参数 | 类型 | 说明 |
  | --- | --- | --- |
  | contidition | HrmExternalEmpContidition | 查询条件 |
  | tenantKey | string | 租户key |
  
    - HrmExternalEmpContidition说明
      
      | 参数 | 类型 | 说明 |
      | --- | --- | --- |
      | contactIds | List<Long> | 客户联系人id列表 |
      | customerIds | List<Long> | 客户id列表 |
      | userIds | List<Long> | 人员账号id列表 |
      | empStatusList | List<UserStatus> | 人员状态； normal 在职；unavailable 离职 |
      | nullContract | boolean | 是否仅查询客户联系人未空的 |
      | externalEmployeeId | Long | 人员id |
      | needLoadAccounttype | boolean | 是否查询次账号列表；true,则会加载externalEmployeeId的次账号列表； 1. 当externalEmployeeId提供的是次账号，则转主账号，然后查询次账号列表 2. 当externalEmployeeId提供的是主账号，查询次账号列表 |
      | containSelf | boolean | 是否包含自己 |
      | needExternalInfo | boolean | 是否返回辅助信息；返回所属客户id,所属客户联系人id |
      | needLoadExternalFullInfo | boolean | 是否返回辅助信息，并详细化； 返回所属客户id和名称,所属客户联系人id和名称 |
      | externalTypes | List<String> | 按照来源查询； wechat 微信 wechatsync  企业微信同步 wechat_wechatsync  微信（企业微信同步） im_sync IM外部用户同步 otherTeams 其他组织加入 crm_customer CRM客户联系人 teams_invite 加入团队 card_add 新增 corpgroup 上下游 srm_jqt 供应商 |
      | nameList | List<String> | 名称查询 |
- 返回说明（WeaResult<List<HrmComExternalInfo>> 仅说明HrmComExternalInfo）
  
  | 参数 | 类型 | 说明 |
  | --- | --- | --- |
  | externalEmployeeId | Long | 人员id |
  | hrmEmployee | HrmEmployee | 人员信息 |
  | employeeExternal | HrmCommonEmployeeExternal | 扩展信息；needExternalInfo=true有内容 |
  | employeeExternalFullInfo | HrmCommonEmployeeExternalFullInfo | 扩展信息-详情；needLoadExternalFullInfo=true才有内容 |
  
    - HrmCommonEmployeeExternal 看[表结构说明](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/8eac53f9-0c8b-45ae-9138-d6089a3f97e4/doc/274300367561293824)
    - HrmCommonEmployeeExternalFullInfo说明
      
      | 参数 | 类型 | 说明 |
      | --- | --- | --- |
      | contactInfo | BrowserDataDto | 客户联系人信息 |
      | customerInfo | BrowserDataDto | 客户信息 |
