# 标准对接流程

组织架构信息,包含企业部门信息、员工信息、角色信息、员工所属部门、员工所属角色、员工证件扩展信息等。 结合过往对接企业同步组织架构信息至美团企业版的一些好的实践经验,推荐一套对接流程,供企业对接时参考。以上信息推荐按照以下顺序对接(标记为可选的步骤,可以根据业务需求,选择是否跳过。例如:如果业务需求里面不包含角色相关信息,则第2、4步可以跳过):

1.同步部门信息[可选]
2.同步角色信息[可选]
3.同步员工信息
4.绑定员工所属角色[可选]
5.绑定员工证件扩展信息[可选]

# 1.同步部门信息[可选]

同步部门信息推荐流程: 同步部门信息推荐流程 部门信息同步至美团企业版,可通过美团企业版企业后台菜单"员工管理->组织架构"查看验证。

TIP

  • 同步部门信息时,先同步上级部门,再同步下级部门。在部门创建时,就可以构建好部门的上下级关系;
  • 建议保存接口返回的美团企业版部门Id与企业侧部门之间的映射关系,部分接口需要用到美团企业版部门Id;
  • 删除部门,建议使用删除部门接口,接口目标明确,不易出错;
  • 删除部门,请确保被删除的部门下无员工和子部门。

# 2.同步角色信息[可选]

如果业务涉及角色,同步角色信息时,推荐按照以下流程对接: 同步角色信息 角色信息同步至美团企业版,可通过美团企业版企业后台菜单"员工管理->角色管理"查看验证。

TIP

  • 保存接口返回的美团企业版角色组id、角色id和企业侧的数据之间的映射关系,其它接口会使用;
  • 如果角色组、角色在企业后台人工创建,可通过分页查询企业现有角色组分页查询角色组下的角色接口查询;
  • 删除角色组,请确保角色组下无角色;
  • 删除角色,请确保角色下无关联员工。

# 3.同步员工信息

同步员工信息推荐流程: 同步员工信息 员工信息同步至美团企业版,可通过美团企业版企业后台菜单"员工管理->组织架构"查看验证。

TIP

  • 员工同步与删除员工接口提供的都是批量对接方式,单次调用可以传送50条员工信息,提升系统之间交互效率, 也可降低接口被限频的概率;
  • 删除员工建议使用批量删除员工接口,接口目标明确,不易出错;
  • 建议保存接口返回的美团企业版员工Id,其它接口可能会使用;
  • 员工与部门绑定,可以通过批量员工同步接口的orgIds或orgUnitCodes字段进行绑定;
  • 员工与默认职级组角色绑定,可以通过批量员工同步接口的level字段进行绑定(前提是职级组相关角色在员工添加 或是更新之前,企业后台已经添加);
  • 如果没同步部门信息,则员工直接挂在企业目录下。

# 4.绑定员工所属角色[可选]

如果业务涉及角色,员工同步完毕之后,即可绑定员工和角色之间的关系,推荐对接流程: 同步员工信息 绑定员工至角色,可通过美团企业版企业后台菜单"员工管理->角色管理"查看验证。

# 5.绑定员工证件扩展信息[可选]

如果业务涉及员工证件扩展信息,推荐调用新增或更新员工证件信息接口进行维护。

上次更新: 4/22/2024, 4:15:08 PM