钉钉和金蝶云星空接口打通对接实战|轻易云数据集成平台

钉钉和金蝶云星空接口打通对接实战

对接系统钉钉

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

对接系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据集成方案配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：钉钉，然后选择对应的连接器。选择对应的获取通讯录作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的员工新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

钉钉接口明细

接口：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
FNumber	编码	string
FUseOrgId	使用组织	string
FCreateOrgId	创建组织	string
FStaffNumber	员工编号	string
FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
Operation	执行的操作	string
IsAutoSubmitAndAudit	提交并审核	bool
IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统数据集成价值

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。