第三方系统和i人事系统员工信息同步说明

最后更新于:2019-11-12 22:20:47

  1. 目的:

第三方系统与i人事系统之间进行基础数据同步;基础信息同步分为2中方式,

  • 从i人事系统拉取数据
  • 向i人事系统写入数据
  1. 名词说明

数据分为元数据和业务数据

元数据:定义业务数据的数据构成和数据项取值定义,如员工信息元数据。

业务数据:HR业务中的实体数据。

 

员工信息元数据:定义了员工信息的属性清单,每个属性的类型,属性的取值范围定义。

 

  1. 从i人事系统拉取数据

 

从i人事系统拉取数据的流程如下图所示:

图:从i人事系统拉取数据流程

I人事的任何业务接口在调用之前均必须有access_token

Access_token的有效期一般为30分钟,建议第三方系统获取AccessToken后存储在本地,在有效期内可以重复调用。

 

I人事的员工信息接口分为2大类,

  • 集合类接口,如获取员工信息清单,获取当日新增员工人员清单等5个接口。此接口返回的值为StaffID的集合,不包含员工的其他数据。
  • 详细信息接口,如获取员工信息概要信息,获取员工信息详情2个接口。此接口返回的值为JSON格式的数据,包含员工的数据,数据定义的格式需要参考"员工信息元数据定义"接口的返回值。

第三方系统从i人事系统获取后,需要将i人事的数据做转换,转为符合内部系统的定义。

I人事员工接口对应的业务场景

接口

接口说明

业务场景

备注

获取员工信息清单

全部员工数据

一般用在首次数据同步

获取当日新增员工人员清单

返回昨日零点起的新增的员工

员工入职

新增员工

 

获取当日员工更新人员清单

返回昨日零点起的员工信息有更新的清单

员工信息修改

员工异动

 

获取当日员工转正人员清单

返回昨日零点起的试用期转正员工

员工转正

 

获取当日员工离职人员清单

返回昨日零点起的离职的员工

员工离职

员工待离职批准

在i人事系统发起离职后,该接口即可返回信息

 

 

  1. 向i人事系统写入数据

向i人事系统写入数据的流程图下图

图:向i人事系统写入数据流程

备注:

在接口开发前,请联系HR获取员工信息集的数据项定义和员工信息子集的数据项定义;确认业务方案后再进行接口开发。

  1. 调用序列

第三方系统和i人事系统之间调用时的序列图如下:

图:调用序列图