管理API接入流程
接入流程图
接入流程解析
step1: 创建部门、项目
基本介绍
- 部门是公司组织架构的基本单位，企业管理员在滴滴创建公司时，滴滴系统会为企业自动创建一个部门， 即公司的顶级部门，之后以顶级部门建立部门层级关系。
- 项目是更小的公司组织架构单位，比如安卓小组成立一个项目中心，然后该组员工共用这个项目中心的经费。
测试步骤
- 查询部门(river/BudgetCenter/get)，调用该接口时(type = 1)，会返回公司目前所有的部门信息，在公司初次注册后调用该接口，会返回顶级部门信息。
- 创建部门(river/BudgetCenter/add)，调用该接口时，可以通过第1步返回的部门集合信息为该部门设置上级部门；如果没有传上级部门id，则新建的部门的上级部门为公司的顶级部门。该接口会返回该部门在滴滴侧的部门id。
- 项目创建步骤同部门创建步骤(type = 2)
step2：创建角色、获取角色信息
基本介绍
- 角色是企业不可或缺的一个特色，通过角色可以控制不同的员工有不同的权限，比如初始超管拥有所有管理权限，主管拥有所负责部门的管理权限。
测试步骤
- 企业初始超管登录滴滴管理后台后，在角色栏中添加角色以及编辑已有角色权限
- 查询角色(river/Role/get)，调用该接口，会返回企业中目前已有的角色信息集合，角色信息中包含该角色在滴滴侧的角色id、角色名称等。
step3：创建用车制度、获取用车制度
基本介绍
- 用车制度是员工用车权限管控的基本单位，通过创建不同的用车制度，并将其配置到员工身上，员工将拥有用车权限，比如加班用车、差旅用车、行前审批用车等。
测试步骤
- 拥有创建用车制度的角色，如初始超管，可登陆滴滴管理后台并在用车管控的用车制度栏新建、编辑、删除加班用车制度、差旅用车制度、需审批用车制度等。
- 查询用车制度(river/Regulation/get)，调用该接口可以获取企业已有的用车制度信息，这些信息包含了用车制度名称、用车制度id等。
step4：员工导入、查询、修改、删除
基本介绍
- 员工是企业的核心元素，通过员工导入接口，并将员工绑定到不同的部门、不同的项目、设置不同的角色以及绑定不同的用车制度，员工即可拥有不同的管理权限和用车权限
测试步骤
- 员工添加(river/member/single)，通过该接口，可以将员工导入到滴滴，并通过step1、step2、step3返回的部门id、项目id、角色id、用车制度id为员工绑定不同的信息。该接口返回了员工在滴滴侧的员工id，企业需要将滴滴侧的员工id与本企业中的员工关系进行映射，从而方便企业侧与滴滴侧员工信息的同步。
- 员工查询(river/member/get)，通过该接口，可以查询员工的信息。
- 员工编辑(river/member/edit)，如果员工的信息发生了变更，比如手机号、用车权限等，需要通过该接口进行同步，保证企业和滴滴侧的员工信息一致性。
- 员工删除(river/member/del)，如果员工在企业中离职，需要通过该接口将员工信息从滴滴中删除，否则仍然拥有相应的用车权限。
step5：创建差旅、行前审批单
基本介绍
- 差旅、行前审批为员工的出差、审批出行提供了便利，通过创建差旅、行前审批单，员工在滴滴企业版APP上就会拥有相应的出差用车权限(临时用车权限)
测试步骤
- 通过员工详情接口(river/member/detail)获取员工拥有的差旅、行前审批用车制度id，项目成本中心id。
- 创建差旅、行前审批单(river/Approval/create)，调用该接口为员工创建差旅、行前审批用车权限。
- 登录企业APP用车或者调起H5页用车
step6：用车、H5订单回调
基本介绍
- 创建差旅或行前审批单后，员工即可登录企业APP或者企业APP H5版用车，如果是使用企业APP，则企业需要使用管理API订单列表接口获取企业订单，如果使用企业APP H5版，则可以通过接入回调获取到订单状态的流转，从而记录更加详细的行程变化信息，如司机何时接单、乘客何时上车等。
测试步骤
- 员工登录企业APP或者企业APP H5用车
- 对于H5订单，如果企业接入了回调，需要接受滴滴侧的回调信息，然后去拉取最新的订单信息