钉钉对接打通金蝶云星空获取通讯录接口与员工新增接口对接系统钉钉钉钉（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 用户的userid string language 通讯录语言 string dep_strategy 部门集成策略ID string 响应参数字段名称类型描述 userid 员工的userid string unionid 唯一标识 string name 员工名称 string avatar 头像 string state_code 国际电话区号 string manager_userid 员工的直属主管 string mobile 手机号码 string hide_mobile 是否号码隐藏 string true：隐藏 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 部门ID string 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 角色ID string leader_in_dept.role_list.name 角色名称 string leader_in_dept.role_list.group_name 角色组名称 string 金蝶云星空接口明细调用接口： batchSave 接口名称：员工新增方法： POST 请求参数字段字段名称类型配置值 FName 名称 string {{name}} FNumber 编码 string {{unionid}} FUseOrgId 使用组织 string 2.01 FCreateOrgId 创建组织 string 2.01 FMobile 手机号 string FStaffNumber 员工编号 string {{userid}} FormId 业务对象表单Id string BD_Empinfo Operation 执行的操作 string BatchSave IsAutoSubmitAndAudit 提交并审核 bool true IsVerifyBaseDataField 验证基础资料 bool false 系统数据集成价值从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通钉钉到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

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

汪淼_轻易云

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

对接系统钉钉

钉钉（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	用户的userid	string
language	通讯录语言	string
dep_strategy	部门集成策略ID	string

响应参数

字段	名称	类型	描述
userid	员工的userid	string
unionid	唯一标识	string
name	员工名称	string
avatar	头像	string
state_code	国际电话区号	string
manager_userid	员工的直属主管	string
mobile	手机号码	string
hide_mobile	是否号码隐藏	string	true：隐藏 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	部门ID	string
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	角色ID	string
leader_in_dept.role_list.name	角色名称	string
leader_in_dept.role_list.group_name	角色组名称	string

金蝶云星空接口明细

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

请求参数

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

系统数据集成价值

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