1.6.1. 同步组织架构信息
Request:
POST /v1.0/hr/organization/sync
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"orgCode": "org_01",
"orgName": "ZKTeco",
"parentOrgCode": "",
"lastUpdateTimeStamp": 1557910639
}
}
}
| 参数名 | 必填 | 描述 |
|---|---|---|
| orgCode | Y | 组织架构编码，企业内唯一 |
| orgName | Y | 组织架构名称 |
| parentOrgCode | N | 父级组织架构编码，若存在父级组织架构编码，则此处必填；若不存在父级组织架构编码，则默认父级组织架构为根组织架构。 |
| lastUpdateTimeStamp | Y | 第三方最后修改时间戳，若该时间戳小于或等于上一次该组织架构接收到的时间戳，则该数据不处理，但会返回成功编码 |
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
注意：
创建公司时已默认创建一个根组织架构
1.6.2. 同步组织架构信息(批量)
Request:
POST /v1.0/hr/organizations/sync
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"organizations": [{
"orgCode": "org_01",
"orgName": "ZKTeco",
"parentOrgCode": "",
"lastUpdateTimeStamp": 1557910639
}]
}
}
}
相关参数描述及注意事项参考同步组织架构信息
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success",
"payload": {
"results": [{
"orgCode": "org_01",
"code": "00000000",
"message": "success"
}]
}
}
1.6.3. 删除组织架构
第三方调用接口删除组织架构信息，若该组织架构存在子集则无法删除。
Request:
POST /v1.0/hr/organization/delete
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"orgCode": "org_01",
"autoUnbindEmployee": "1",
"lastUpdateTimeStamp": 1557910639
}
}
}
| 参数名 | 必填 | 描述 |
|---|---|---|
| orgCode | Y | 组织架构编码 |
| autoUnbindEmployee | Y | 是否自动解绑该部门关联的员工，1:是，0:否（默认），若为否，则必须先解绑该组织架构关联的人员信息。 |
| lastUpdateTimeStamp | Y | 第三方最后修改时间戳，若该时间戳小于或等于上一次该组织架构接收到的时间戳，则该数据不处理，但会返回成功编码 |
删除组织架构需注意
- 需先删除其子组织架构，才能删除；
- 需先解绑该部门关联的员工，才能删除，设置autoUnbindEmployee=1则无需考虑此问题；
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success"
}
1.6.4. 删除组织架构(批量)
第三方调用接口删除组织架构信息，若该组织架构存在子集则无法删除。
Request:
POST /v1.0/hr/organizations/delete
Content-Type: application/json
Authorization: ACCESS_TOKEN
Timestamp: 1529223702
{
"lang": "zh-cn",
"usr": "username",
"pwd": "password",
"payload": {
"params": {
"autoUnbindEmployee": "1",
"organizations": [{
"orgCode": "org_01",
"lastUpdateTimeStamp": 1557910639
}]
}
}
}
相关参数描述及注意事项参考删除组织架构
Response：
{
"code": "00000000",
"mid": "xxx",
"message": "success",
"payload": {
"results": [{
"orgCode": "org_01",
"code": "00000000",
"message": "success"
}]
}
}