钉钉对接打通金蝶云星空获取通讯录接口与员工新增接口

钉钉对接打通金蝶云星空获取通讯录接口与员工新增接口

对接系统钉钉

钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。

对接目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

配置集成方案

通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的topapi/v2/user/get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

钉钉接口明细

• 接口：topapi/v2/user/get
• 接口名称：获取通讯录
• 接口方法：POST

请求参数

字段名称类型描述 userid用户的useridstring language通讯录语言string dep_strategy部门集成策略IDstring

响应参数

字段名称类型描述 userid员工的useridstring unionid唯一标识string name员工名称string avatar头像string state_code国际电话区号string manager_userid员工的直属主管string mobile手机号码string hide_mobile是否号码隐藏stringtrue：隐藏 false：不隐藏 说明 隐藏手机号后，手机号在个人资料页隐藏，但仍可对其发DING、发起钉钉免费商务电话。 telephone分机号string job_number员工工号string title职位string email员工邮箱string work_place办公地点string remark备注string login_id专属帐号登录名string exclusive_account_type专属帐号类型string专属帐号类型： sso：企业自建专属帐号 dingtalk：钉钉自建专属帐号 dept_id_list所属部门ID列表array dept_id部门IDstring order员工在部门中的排序string extension扩展属性string hired_date入职时间string入职时间，Unix时间戳，单位毫秒。 active是否激活了钉钉string real_authed是否完成了实名认证string senior是否为企业的高管string admin是否为企业的管理员string boss是否为企业的老板string leader_in_dept员工在对应的部门中是否领导array leader_in_dept.dept_id部门string leader_in_dept.leader是否是领导string leader_in_dept.role_list角色列表array leader_in_dept.role_list.id角色IDstring leader_in_dept.role_list.name角色名称string leader_in_dept.role_list.group_name角色组名称string

金蝶云星空接口明细

• 调用接口：batchSave
• 接口名称：员工新增
• 方法：POST

请求参数

字段字段名称类型配置值 FName名称string{{name}} FNumber编码string{{unionid}} FUseOrgId使用组织string2.01 FCreateOrgId创建组织string2.01 FMobile手机号string FStaffNumber员工编号string{{userid}} FormId业务对象表单IdstringBD_Empinfo Operation执行的操作stringBatchSave IsAutoSubmitAndAudit提交并审核booltrue IsVerifyBaseDataField验证基础资料boolfalse

系统数据集成价值

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通钉钉到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。