---
title: "同步外部联系人"
docId: "233310392342806528"
source: "https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/91f5067f-775e-48f4-93a2-ce84ca0b9c2e/doc/233310392342806528"
---
## 1. 同步外部联系人

```java
com.weaver.common.hrm.remote.external.HrmRemoteExternalService#syncExternalEmployee
```

- 入参
  
  | 参数 | 类型 | 说明 |
  | --- | --- | --- |
  | datas | List<Map<String,Object>> | 数据报文 |
  | tenantKey | string | 租户 |
  | optId | Long | 操作者 (如果是新建人员，则是邀请人) |
  | virtualId | Long | 多维id |
  | formType | HrmOperateFromType | 来源：HrmOperateFromType |
- 数据报文(List<Map<String,Object>>)

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| username | string | 姓名 |
| sex | string | 性别 |
| locationName | string | 办公地点 |
| note | string | 备注 |
| email | string | 邮箱 |
| mobile | string | 手机 |
| telephone | string | 电话 |
| customer | Long | 关联客户 |
| contact | Long | 关联客户联系人 |
| employeeExternalType | HrmEmployeeExternalType | 来源 |
| subcompany | Long | 企业 |
| department | Long | 部门 |
| account | String | 账号 |
| loginMobile | string | 登录手机 |
| loginEmail | string | 登录邮箱 |
| loginid | string | 登录名 |
| password | string | 密码 |
| sec_level | integer | 安全级别 |
| id | Long | 人员id；修改的时候提供，新增的时候不能提供 2507+基线支持 |
| personnel_status | String | 状态；3 有效，6 离职 10 无效 2507+基线支持 自定义状态在【组织架构设置-人事状态设置】的 外部用户状态中设置 表结构看【[https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/8eac53f9-0c8b-45ae-9138-d6089a3f97e4/doc/962013472507297793](https://weapp.eteams.cn/build/techdoc/wdoc/index.html#/public/repository/8eac53f9-0c8b-45ae-9138-d6089a3f97e4/doc/962013472507297793)】 |

## 2. 同步外部联系人（简易版本）

```java
// dubbo接口
com.weaver.common.hrm.remote.HrmRemotingExtService#syncData
```

- 入参说明
  
  | 参数 | 类型 | 说明 |
  | --- | --- | --- |
  | params | Map<String,Object> | 入参 |
  | tenantKey | String | 租户 |
  | optId | Long | 操作者 |
  
    - params说明
      
      | 参数 | 类型 | 说明 |
      | --- | --- | --- |
      | needDefaultVirtual | boolean | 是否默认外部联系人维度 |
      | data | List<Map<String,Object>> | 数据集合，内容与#1同步外部联系人文档中datas一致 |
      | cmd | string | 固定值: extEmp |
      | fromType | string | 来源；必须是HrmOperateFromType的其中一个 |
      
          - 数据规则
- 入参示例
  
  ```json
  
  {
    "cmd": "extEmp",
    "data": [
      {
        "username": "账号三001"
      }
    ],
    "tenantKey": "tpo43o6r12",
    "optId": "1145025237538308107",
    "fromType": "CLOUD_STORE",
    "needDefaultVirtual": true
  }
  ```
- 返回内容示例（WeaResult<Map<String, Object>>）
  
  ```json
  {
    "code": 200,
    "msg": "接口返回成功",
    "status": true,
    "data": { // 1258523965772283905 是人员id
      "1258523965772283905": {
        "keyValue": "null",
        "id": 1258523965772283905,
        "operate": "ADD",
        "status": "SUCCESS",
        "errcode": "SUCCESS",
        "needRepush": false,
        "extKeyMap": {
          "index": 1
        }
      }
    },
    "fail": false
  }
  ```
